Chat Clients
Step-by-step setup for connecting Claude, Claude Cowork, ChatGPT, Gemini Enterprise and other MCP chat clients to Credible's MCP server, and what the MCP URL scopes do
Connect a chat client such as Claude or ChatGPT to Credible, and it can answer questions from your published data models, outside the Credible app. For Claude Code, Codex, Cursor and other coding tools, see Coding Agents.
The client connects to Credible's MCP server, and you sign in as yourself. Every query then runs with your permissions, and the model's access rules apply as they do in the app.
Prerequisites
-
You need a Credible account in an organization with at least one published package you can read.
-
The MCP server URL is:
https://mcp.credibledata.com/global/ -
In the Credible app, Connect AI shows these steps with the URL filled in. Every role can open it.
Connecting your own chat client is not metered by Credible: the client's tokens are yours. See pricing.
The MCP URL and Scopes
The URL above covers every organization, workspace and package your account can read. Credible works out what you can reach from who you signed in as, so there is nothing organization-specific to look up.
Connect AI can also give you a narrower URL, for one organization, one shared workspace, or one package (from the package's settings). A narrower URL changes where the client starts looking. It is not access control: every request is checked against the signed-in person's permissions, whatever the URL. Handing someone a narrower URL gives them no access they didn't already have. The URL shapes are on MCP Server and Tools.
The Claude plugin and the Claude directory listing always connect with the full URL. To use a narrower one in Claude, add it by URL (below).
Claude
For claude.ai, Claude Desktop and the Claude mobile apps. There are three ways to connect, from most to least complete.
Install the Credible plugin (connection and skills)
The plugin installs the connection and the analysis skills that teach Claude how to use it. It works in claude.ai, in the Chat tab of Claude Desktop, and in Cowork.
- Open Customize in the sidebar, then the Plugins tab.
- Under Personal plugins, click + and choose Add marketplace.
- Enter
credibledata/credible-plugin, then click Sync. - Install Credible from the list.
- Open the installed plugin, go to its Connectors tab, and click Connect. Installing the plugin does not sign you in; this step does.
Add the connector from the directory (connection only)
Credible is listed in Anthropic's connector directory.
- Open claude.ai/directory/credible (opens in a new tab), or find Credible under Customize, Connectors, Browse connectors.
- Click Connect and sign in to Credible.
A connector added to your Claude account works across claude.ai, Desktop and mobile.
Add the connector by URL
Use this for a narrower URL from Connect AI.
- Open Customize, then Connectors.
- Click +, then Add custom connector.
- Enter the name
Credibleand the MCP server URL. - Leave the OAuth fields empty and click Add.
- Click Connect and sign in to Credible.
Claude Team and Enterprise plans
Members can't add connectors themselves. An Owner or Primary Owner adds Credible under Organization settings, Connectors (Add, then Custom, Web). Each member then connects and signs in under Customize, Connectors. On a Team plan, the directory listing shows members a Request button that sends the request to the Owners.
Claude Cowork
Cowork uses the same plugin as Claude. Follow the plugin steps, but open the Cowork tab first, then Customize. Cowork also shares your Claude account's connectors, so a connector added in claude.ai works in Cowork.
ChatGPT
ChatGPT connects through developer mode, on the web app. Developer mode is available on Plus, Pro, Business, Enterprise and Education accounts. On a Business, Enterprise or Education workspace, an admin has to allow it first, under Workspace settings, Permissions & roles, Connected data.
- Open Settings, Security and login, and turn on Developer mode.
- Open Plugins, click +, and create a developer-mode app for a remote MCP server.
- Enter the name
Credibleand a description. - Enter the MCP server URL.
- Leave authentication as OAuth, then connect and sign in to Credible.
Ask ChatGPT to use Credible by name in a conversation. On Business plans a published app can't be edited afterwards; to change it, create and publish it again. OpenAI renames this area often: if a label doesn't match, look for the nearest equivalent.
Gemini Enterprise
Gemini Enterprise is available on request. It asks for OAuth client credentials when you add a custom MCP server, instead of registering itself, so Credible enables it for your organization: contact support to set it up. Connect AI has no Gemini entry.
The Gemini consumer app does not take custom MCP servers. The Gemini CLI connects like any other coding agent; see Coding Agents.
Other MCP Clients
Credible is a remote MCP server over Streamable HTTP. Sign-in is OAuth with dynamic client registration: the client registers itself, so there is no key to copy and no client ID to configure. Any client that takes a server URL and handles OAuth this way can connect with the MCP server URL.
What Your Client Can Do
After you connect, the client has get_context to find the sources and fields a question needs, execute_query to run Malloy queries, search_malloy_docs for Malloy language help, and get_skill to read Credible's analysis guides. Called with nothing to search, get_context lists the organizations, environments and packages you can reach. If you have several to choose from, the client asks which to use. See MCP Server and Tools.
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| Claude shows no Credible data after installing the plugin | Installing the plugin doesn't connect it | Open the plugin's Connectors tab and click Connect |
Failed to add marketplace in Claude | Credible's listing in the anthropics/claude-plugins-community catalog fails in that dialog, and it can lag behind releases | Use credibledata/credible-plugin |
| The client sees fewer packages than expected | You connected with a narrower URL, or your account can't read those packages | Check the URL you connected with, and whether you can read those packages in the Credible app |