Skip to main content
Connect your favorite AI assistant to Aident’s full platform — 1000+ integrations, playbooks, templates, and dashboard — through the Model Context Protocol (MCP).

Prerequisites

  • Active Aident account
  • Connected integrations (Settings → Integrations)
  • An MCP-compatible client

Step 1: Add Server URL

All MCP clients use the same server URL:
https://app.aident.ai/api/mcp
Run in your terminal:
claude mcp add --transport http aident https://app.aident.ai/api/mcp
Or add to ~/.claude.json:
{
  "mcpServers": {
    "aident": {
      "type": "http",
      "url": "https://app.aident.ai/api/mcp"
    }
  }
}
Add to your config file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "aident": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.aident.ai/api/mcp"]
    }
  }
}
Or on Pro/Max/Team/Enterprise plans: Settings → Connectors → Add and enter https://app.aident.ai/api/mcp.
Add to .cursor/mcp.json in your project root:
{
  "mcpServers": {
    "aident": {
      "url": "https://app.aident.ai/api/mcp"
    }
  }
}
Add to .vscode/mcp.json in your project root:
{
  "servers": {
    "aident": {
      "type": "http",
      "url": "https://app.aident.ai/api/mcp"
    }
  }
}
Add to ~/.codeium/windsurf/mcp_config.json:
{
  "mcpServers": {
    "aident": {
      "serverUrl": "https://app.aident.ai/api/mcp"
    }
  }
}
Go to Settings → MCP Servers → Add Server, then enter:
https://app.aident.ai/api/mcp
Add to ~/.gemini/settings.json:
{
  "mcpServers": {
    "aident": {
      "httpUrl": "https://app.aident.ai/api/mcp"
    }
  }
}
Any MCP-compatible client (Codex, Goose, Kiro, OpenCode, Antigravity, Factory, etc.) can connect using the server URL https://app.aident.ai/api/mcp. Refer to your client’s documentation for where to add MCP server configurations.

Step 2: Authenticate

On first use, your MCP client will automatically:
  1. Discover Aident’s OAuth endpoints
  2. Open your browser for login (Google OAuth or magic link)
  3. Store your access token locally
No manual token management needed — the client handles everything.

Step 3: Verify Connection

In your MCP client, try asking your AI assistant to use Aident tools. You should see 22 tools available across auth, skills, integrations, playbooks, templates, and dashboard.

Switching Accounts

To log out or switch to a different Aident account, use the auth_logout tool, then reconnect to trigger a new sign-in flow.

Troubleshooting

Authentication Issues

If the OAuth flow doesn’t start automatically:
  1. Restart your MCP client
  2. Verify URL is exactly https://app.aident.ai/api/mcp
  3. Check that your browser can reach app.aident.ai

”Skill requires unauthenticated integrations”

The skill needs integrations you haven’t connected:
  1. Run integration_status to see what’s connected
  2. Run integration_connect with the missing integration
  3. Authorize in browser
  4. Retry the operation

Connection Timeout

  • Check firewall allows outbound HTTPS to app.aident.ai
  • Configure proxy in MCP client if needed
  • Try disconnecting VPN temporarily

Tools Not Appearing

  1. Restart MCP client
  2. Verify URL in configuration file
  3. Re-authenticate if token expired (client should handle automatically)

Managing Your Connection

Revoking Access

  1. Go to Settings → Integrations → MCP
  2. Click “Revoke Access”
  3. All MCP connections will stop working immediately
  4. Re-authenticate to reconnect

Multiple Clients

You can use the same Aident account across multiple MCP clients. Each client maintains its own OAuth tokens.