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

# How do I connect Claude Code?

> Add Klipy's MCP server to Claude Code from your terminal and authenticate with OAuth.

Klipy connects to Claude Code through the same remote MCP server every client uses. Add the server with one command in your terminal, then authenticate with OAuth. Once connected, ask Claude Code about your Klipy pipeline, contacts, and conversations directly from the terminal; every write action still goes through Klipy's normal review process.

<Info>
  Klipy's MCP server is supervised — every write action still goes through the same review Klipy applies everywhere else. See [how the MCP server works](/docs/guides/mcp/overview) before connecting.
</Info>

## How do I connect Claude Code to Klipy?

<Steps>
  <Step title="Add the Klipy MCP server">
    From your terminal, run:

    ```bash theme={null}
    claude mcp add --transport http klipy https://api.klipy.ai/mcp
    ```

    This adds Klipy as a local-scoped HTTP server for the current project. If you want Klipy available across every project on your machine, add `--scope user`:

    ```bash theme={null}
    claude mcp add --transport http klipy --scope user https://api.klipy.ai/mcp
    ```
  </Step>

  <Step title="Authenticate with OAuth">
    Klipy's MCP server requires OAuth 2.0. Inside a Claude Code session, run:

    ```text theme={null}
    /mcp
    ```

    Select `klipy` and follow the browser login flow. You can also authenticate directly from your shell without opening a session:

    ```bash theme={null}
    claude mcp login klipy
    ```

    <Note>
      Connecting over SSH or another environment without a local browser? Claude Code detects this and prints an authorization URL instead of opening a browser. Open that URL on your local machine, then paste the full redirect URL from your browser's address bar back at the prompt. Use `ssh -t` so the paste step has an interactive terminal, or pass `--no-browser` to force the URL prompt.
    </Note>
  </Step>

  <Step title="Verify it works">
    Ask Claude Code:

    ```text theme={null}
    Who am I in Klipy?
    ```

    Claude Code calls the `get_current_user` tool and returns your Klipy account details. If it responds with your name and workspace, the connection is authenticated and ready.
  </Step>
</Steps>

## What can I do once Claude Code is connected?

Ask Claude Code about your Klipy pipeline, contacts, or conversations from any terminal session.

<Card title="Explore what you can do" icon="compass" href="/docs/guides/mcp/use-cases">
  See example prompts and workflows once Claude Code is connected.
</Card>