Connecting Your Agent

Connecting takes about a minute: you add YAPL's connector URL to your agent, sign in with your YAPL account, and approve access. No API keys, nothing to install in YAPL itself.

Prerequisites

• Your YAPL workspace must be on a Professional or Trial plan — the MCP Connector for AI Agents is not included in Basic. The check runs on every agent call, so if a workspace later downgrades or its trial ends, connected agents are refused immediately (even ones authorized earlier) until the plan is upgraded again.
• An agent that supports remote MCP servers with OAuth sign-in (see below).

The connector URL is the same for every agent:

https://yapl.app/api/mcp

Connecting Claude

Claude supports custom connectors on claude.ai, in Claude Desktop, and in Claude Code.

1. Open Claude's connector settings (on claude.ai: Settings > Connectors > Add custom connector; in Claude Code: claude mcp add --transport http yapl https://yapl.app/api/mcp).
2. Enter the connector URL above and confirm.
3. Your browser opens YAPL's sign-in. Sign in with your normal YAPL account if you aren't already.
4. Review the consent screen and approve. It asks to share your basic profile identity (so the agent client knows who you are) and to let the client act on YAPL as your user.
5. Back in Claude, the YAPL tools appear. Try: "List my plans."

One connection per Claude surface. claude.ai, Claude Desktop, and Claude Code each register their own connection, so you may connect more than once and later see more than one "Claude" entry under Settings > Integrations > MCP Connectors — the connection time and client ID on each card tell them apart.

Connecting Any Other MCP-Compatible Agent

YAPL's connector follows the MCP standard with no client-specific extensions, so any agent that supports remote MCP servers over Streamable HTTP with OAuth sign-in can connect — the agent registers itself automatically (the standard's dynamic client registration), so there is nothing to configure on the YAPL side first.

In your agent's MCP or integrations settings:

1. Add a remote MCP server with the URL https://yapl.app/api/mcp.
2. When the agent starts the sign-in flow, your browser opens YAPL — sign in and approve, exactly as above.
3. The agent discovers YAPL's tools automatically.

Whatever the client, the rules are identical: the agent gets your permissions and nothing more, the same live-vs-draft model applies, and you can revoke it at any time. If your agent supports MCP but fails to connect, see Troubleshooting.

Revoking Access

Every connected client is listed under Settings > Integrations > MCP Connectors, with its name, client ID, and when you approved it. Click Revoke on a card to disconnect that client immediately — it loses all access until you approve it again. Revoking one client doesn't affect the others.