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:Claude Code
Claude Code
Run in your terminal:Or add to
~/.claude.json:Claude Desktop
Claude Desktop
Add to your config file:Or on Pro/Max/Team/Enterprise plans: Settings â Connectors â Add and enter
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
https://app.aident.ai/api/mcp.Cursor IDE
Cursor IDE
Add to
.cursor/mcp.json in your project root:VS Code (Copilot)
VS Code (Copilot)
Add to
.vscode/mcp.json in your project root:Windsurf
Windsurf
Add to
~/.codeium/windsurf/mcp_config.json:ChatGPT Desktop
ChatGPT Desktop
Go to Settings â MCP Servers â Add Server, then enter:
Gemini CLI
Gemini CLI
Add to
~/.gemini/settings.json:Other Clients
Other Clients
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:- Discover Aidentâs OAuth endpoints
- Open your browser for login (Google OAuth or magic link)
- Store your access token locally
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 theauth_logout tool, then reconnect to trigger a new sign-in flow.
Troubleshooting
Authentication Issues
If the OAuth flow doesnât start automatically:- Restart your MCP client
- Verify URL is exactly
https://app.aident.ai/api/mcp - Check that your browser can reach app.aident.ai
âSkill requires unauthenticated integrationsâ
The skill needs integrations you havenât connected:- Run
integration_statusto see whatâs connected - Run
integration_connectwith the missing integration - Authorize in browser
- 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
- Restart MCP client
- Verify URL in configuration file
- Re-authenticate if token expired (client should handle automatically)
Managing Your Connection
Revoking Access
- Go to Settings â Integrations â MCP
- Click âRevoke Accessâ
- All MCP connections will stop working immediately
- Re-authenticate to reconnect