Connect Claude Desktop

Claude Desktop reads MCP server definitions from a JSON file. Add your
server, restart, and your tools appear under your publication's name.

Config snippet

Copy this from your MCP page → "Client
Configuration":

{
  "mcpServers": {
    "your-slug": {
      "url": "https://oasy.your-domain.com/mcp"
    }
  }
}

(Or the long form https://api.oasy.ai/api/mcp/<orgId> if you haven't
verified your CNAME yet.)

Where the file lives

If the file doesn't exist, create it. If it does, merge the mcpServers
key — don't overwrite.

Restart

Quit Claude Desktop fully (Cmd-Q / Alt-F4 — not just close the window),
relaunch. Your tools appear in the 🔌 Tools menu under the slug.

First call with OAuth

If you've flipped Require auth on, Claude opens a browser tab on first
connect for the OAuth flow:

1. The /authorize consent screen renders with your branding.
2. Reader enters their email and accepts terms.
3. Returns to Claude with a bearer token.

After that, every MCP call carries the token and the meter keys off the
OAuth client_id.

Test it

In Claude Desktop, ask:

Search [your-publication] for articles about [topic].

You should see Claude call search_articles (visible in the tools panel)
and respond with results.

Troubleshooting

• "Tool not found" — config file is malformed. Check JSON syntax.
• "Server unreachable" — verify https://oasy.your-domain.com/mcp
  loads in a browser (you'll see an MCP discovery JSON).
• No OAuth tab opens — confirm Require auth is actually on in your
  dashboard. Without it, Claude connects anonymously.