> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timbal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude

> Learn how to connect Timbal to Claude in the browser with OAuth or in Claude Code with a Timbal API Key via MCP.

Use **[OAuth on Claude.ai](#mcp-oauth)** in your browser, or a **[Timbal API Key with Claude Code](#mcp-api-key)** (the `claude` CLI).

<a id="mcp-oauth" />

## Claude.ai: OAuth

> ### Step 1: Open Claude.ai

1. In your browser, open [claude.ai](https://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](https://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.

   <Warning>
     Make sure to log in with your active Timbal account — the account registered on the [Timbal Platform](https://app.timbal.ai). Using a different account may prevent access to Timbal tools.
   </Warning>

<a id="mcp-api-key" />

## Claude Code: API Key

> ### Step 1: Open Claude Code

1. Install [Claude Code](https://docs.claude.com/en/docs/claude-code/setup) (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:

   ```bash theme={"dark"}
   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.

<Note>
  You can choose another server name instead of `timbal-mcp`; it is only a label in your local Claude Code configuration.
</Note>

<Info>
  See the [Authentication documentation](https://docs.timbal.ai/api-reference/authentication#authentication) for instructions on generating an API Key.
</Info>

> ### 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.