> ## Documentation Index
> Fetch the complete documentation index at: https://ago.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Claude Web to AGO

> Use Claude Web's custom connectors to access your AGO knowledge, conversations, and tickets through MCP.

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:

```
https://<your-tenant>.api.useago.com/api/v1/mcp
```

Replace `<your-tenant>` with your subdomain (e.g. `acme`).

## Step 2 — Add the custom connector in Claude Web

1. Open Claude Web → **Settings** → **Connectors**.
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:

```
claude-web
```

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.