MCP Getting Started

5 min readLast updated View as MarkdownAgent setup

Apptonomy runs a remote MCP server (Model Context Protocol), so an AI client such as Claude can read your Apptonomy data while you work with it: “which of my apps lost score this week?”, “what does the latest audit recommend for the subtitle, and why?”. The client signs in as you, and reads only what your organization’s Owner or Manager has granted that client.

Supported clients

ClientStatus (checked 2026-11-17)
Claude — claude.ai, Claude Desktop, Claude mobile appsSupported
Claude CodeSupported
ChatGPTSupported
Slack (Slackbot)Supported (checked 2026-11-18)
Google GeminiNot supported yet (see the note at the top of this page)
Cursor and other clientsNot supported

A client that isn’t supported can’t connect. The server speaks the MCP 2026-07-28 revision and the 2025 revisions before it, over Streamable HTTP.

How access works

Two things must both be true for a call to succeed:

  1. You are a member of the organization the call names, and your role allows what it reads or does.
  2. An Owner or Manager has granted your client access to that organization. A grant is for one member and one AI client — say, you on Claude — and says what the client may read and in which projects.

Signing in proves who you are and which client you’re using; it doesn’t by itself give access to anything. Both checks run again on every call, so a change to membership or grants applies to the very next request.

One connection reaches every organization you belong to. The connection isn’t tied to one of them: the client first lists your organizations, then names an organization or project on each call. An organization that hasn’t granted your client stays unreachable while the others keep working.

Apptonomy can’t tell a personal Claude or ChatGPT account from a company one: the same member signing in from either is served the same data under the same grant.

For Owners and Managers: grant access

  1. Open Org Settings › API Access and find AI client access.
  2. Click Grant access.
  3. Choose the member and the AI client.
  4. Under What the client can read, tick what it may read. By default that is everything except Personal data (names, emails and user ids).
  5. Under Projects, keep All projects, including ones created later, or pick specific projects.
  6. Tick Allow actions only if the member’s client should start audits, write draft listings and change recommendations’ state (Actions). Off, the client only reads.
  7. Optionally set when it Expires; leave it empty for access that lasts until revoked.
  8. Click Grant access.

Each member and client pair has one grant; granting again replaces it. Every grant and revocation is in the organization’s audit log as “AI client access granted” and “AI client access revoked”. AI client access is available on every plan.

For members: connect your client

The server URL is:

https://api.apptonomy.ai/v1/mcp

Type it exactly, with no trailing slash.

Claude (claude.ai, Desktop, mobile): go to Settings › Connectors, choose Add custom connector, give it a name (for example “Apptonomy”) and paste the URL. Claude opens Apptonomy’s sign-in; sign in with your Apptonomy account and approve the connection.

Claude Code:

claude mcp add --transport http apptonomy https://api.apptonomy.ai/v1/mcp

Then run /mcp inside Claude Code and choose Authenticate to sign in.

ChatGPT: open Plugins, choose Add › Add custom MCP server, give it a name (for example “Apptonomy”) and paste the URL. Leave Authentication on OAuth, confirm the notice about custom servers and click Create, then Connect. ChatGPT opens Apptonomy’s sign-in; sign in with your Apptonomy account and approve the connection.

Slack (Slackbot): Slackbot reaches Apptonomy through the Apptonomy Slack app, so the app must be installed in your Slack workspace first (see Slack); you don’t paste the server URL. A workspace that installed the app before 2026-11-17 needs it reinstalled once to pick up the connection. Then open Slackbot, click the apps icon in its message box and choose Manage apps. Select Apptonomy and connect it: Slack opens Apptonomy’s sign-in in a new window; sign in with your Apptonomy account and approve the connection. The first time you ask Slackbot for Apptonomy data it asks whether to connect Slackbot to Apptonomy (choose Turn On) and then whether it may run the tool (Allow Once or Always Allow).

Once connected, ask something like “List my Apptonomy organizations” to check the connection. If an organization shows a grant status other than active, ask one of its Owners or Managers to grant your client.

Next steps

  • Tools — what a connected client can read
  • Actions — what it can start or write when the grant allows actions
  • Limits & Data Handling — request limits, and what the client and Apptonomy keep
  • Troubleshooting — disconnecting, revoking access, and every error a client can show
  • API Getting Started — the same data for your own code, with API keys