Before you start
You need:- An AGO account (the email/password you use at
https://your-tenant.useago.com). - A Claude Web account on Free, Pro, Max, Team, or Enterprise. Free is limited to one custom connector.
- Your tenant subdomain — the part before
.useago.comin your AGO URL.
Step 1 — Find your MCP URL
Your MCP endpoint is:<your-tenant> with your subdomain (e.g. acme).
Step 2 — Add the custom connector in Claude Web
- Open Claude Web → Settings → Connectors.
- Click Add custom connector.
- Name:
AGO - URL: paste the MCP URL from Step 1.
- Click Add.
Step 3 — Paste the AGO client_id
Claude Web will detect that AGO uses OAuth and ask for a client_id. Use:
client_secret field empty — AGO uses PKCE for public clients, no secret is needed.
Step 4 — Sign in and approve scopes
- Click Connect. A browser tab opens.
- Sign in to AGO if you’re not already.
- Review the scopes Claude is requesting (e.g.
knowledge:read,conversations:read). - Click Allow access.
Step 5 — Try it
Start a new Claude conversation and ask:What knowledge bases do I have in AGO?Claude will use the MCP tools to read your knowledge sources and answer.
Revoke access
Sign in to AGO → Admin → Settings → OAuth Connections to see active tokens. Click Revoke on the Claude row to disconnect immediately.Troubleshooting
“Sign-in popup didn’t open” — your browser blocked the popup. Allow popups forclaude.ai and try Connect again.
“Invalid authorization link” — the consent link expired (10 minutes). Restart the connection from Claude Web.
“Unknown client_id” — double-check that you pasted exactly claude-web (no spaces, no quotes).
“Connection failed: 404” — the MCP URL is wrong. Confirm your tenant subdomain matches your AGO URL.
Tokens stay valid for 1 hour — Claude refreshes them automatically using a 30-day refresh token. If you don’t use Claude for 30 days you’ll need to reconnect.