Skip to main content
This guide takes you from zero to your first MCP tool call in Claude Web in under two minutes.

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.com in your AGO URL.

Step 1 — Find your MCP URL

Your MCP endpoint is:
Replace <your-tenant> with your subdomain (e.g. acme).

Step 2 — Add the custom connector in Claude Web

  1. Open Claude Web → SettingsConnectors.
  2. Click Add custom connector.
  3. Name: AGO
  4. URL: paste the MCP URL from Step 1.
  5. Click Add.

Step 3 — Paste the AGO client_id

Claude Web will detect that AGO uses OAuth and ask for a client_id. Use:
Leave the client_secret field empty — AGO uses PKCE for public clients, no secret is needed.

Step 4 — Sign in and approve scopes

  1. Click Connect. A browser tab opens.
  2. Sign in to AGO if you’re not already.
  3. Review the scopes Claude is requesting (e.g. knowledge:read, conversations:read).
  4. Click Allow access.
The tab closes and Claude Web shows Connected.

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 for claude.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.