Claude

Use OAuth on Claude.ai in your browser, or a Timbal API Key with Claude Code (the claude CLI).

​

Claude.ai: OAuth

​

Step 1: Open Claude.ai

1. In your browser, open claude.ai and sign in.

​

Step 2: Access Connectors

1. In the left sidebar, open Customize → Connectors, or go directly to claude.ai/customize/connectors.

​

Step 3: Add Timbal as a new MCP server

1. Click the + button (next to the search control), then choose Add custom connector.
2. Add the Timbal MCP URL (https://api.timbal.ai/mcp). For example, you can name the connector timbal-mcp.
3. When timbal-mcp appears in the list as a custom connector, click Connect.
4. A browser window will open to complete Timbal authentication.
5. Log in using your preferred method: GitHub, Google, Microsoft, or Timbal OAuth.
6. Accept the OAuth permissions when prompted and continue.
7. Return to Claude — you can use Timbal tools in chat.
   Make sure to log in with your active Timbal account — the account registered on the Timbal Platform. Using a different account may prevent access to Timbal tools.

​

Claude Code: API Key

​

Step 1: Open Claude Code

1. Install Claude Code (the claude CLI) on your machine if you have not already.
2. Open a terminal where you want to use Timbal tools with Claude.

​

Step 2: Add Timbal as a new MCP server

1. Run the following, replacing <TIMBAL_API_KEY> with your Timbal API Key:
   Copy

   claude mcp add --transport http timbal-mcp https://api.timbal.ai/mcp \
     --header "Authorization: Bearer <TIMBAL_API_KEY>"
   
2. If you already added timbal-mcp without a header, run claude mcp remove timbal-mcp, then run the command again.

​

Step 3: Start using Timbal in Claude Code

1. Run claude and work in your repository as usual.
2. Start a chat.
3. You can now use Timbal tools in your conversation. Claude Code will automatically leverage the MCP integration.
4. Approve tool runs when Claude Code prompts you, if your security settings require confirmation.