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

# Getting Started

> Connect your Klark account to your AI assistant in 30 seconds

## Installation

Choose your AI client and follow the matching instructions.

<Tabs>
  <Tab title="Claude Desktop">
    ### 1. Open the configuration file

    ```bash theme={null}
    open ~/Library/Application\ Support/Claude/claude_desktop_config.json
    ```

    <Note>
      On Windows: `%APPDATA%\Claude\claude_desktop_config.json`
    </Note>

    ### 2. Add the Klark server

    ```json claude_desktop_config.json theme={null}
    {
      "mcpServers": {
        "klark": {
          "command": "npx",
          "args": ["mcp-remote", "https://api.klark.app/v1/mcp"]
        }
      }
    }
    ```

    <Info>
      Claude Desktop does not yet natively support remote MCP servers. The `mcp-remote` package bridges the stdio protocol and HTTP.
    </Info>

    ### 3. Restart Claude Desktop

    Quit the application completely (Cmd+Q) and reopen it. Claude will automatically detect the Klark server.

    ### 4. Authenticate

    Your browser will open on the Klark consent page. Sign in with your email and password, then authorize access.

    <Check>
      The Klark tools appear in Claude Desktop (hammer icon). You can start using them!
    </Check>
  </Tab>

  <Tab title="Cursor">
    ### 1. Open the MCP settings

    Go to **Settings** > **MCP Servers** > **Add Server**.

    ### 2. Add the configuration

    ```json theme={null}
    {
      "mcpServers": {
        "klark": {
          "url": "https://api.klark.app/v1/mcp"
        }
      }
    }
    ```

    ### 3. Authenticate

    Cursor will automatically open your browser for OAuth authentication.

    <Check>
      The Klark tools are now available in Cursor.
    </Check>
  </Tab>

  <Tab title="Claude Code">
    ### 1. Add the server

    ```bash theme={null}
    claude mcp add klark https://api.klark.app/v1/mcp
    ```

    ### 2. Authenticate

    The first time you use a Klark tool, your browser will open for authentication.

    <Check>
      That's it! The Klark tools are ready.
    </Check>
  </Tab>

  <Tab title="Other MCP client">
    Configure your client with the following settings:

    | Setting        | Value                          |
    | -------------- | ------------------------------ |
    | Server URL     | `https://api.klark.app/v1/mcp` |
    | Transport      | Streamable HTTP                |
    | Authentication | OAuth 2.0 (automatic)          |

    <Info>
      Check your MCP client's documentation to learn how to add a remote server.
    </Info>
  </Tab>
</Tabs>

## Test the connection

Once connected, try these commands in your AI assistant:

```
List my clients
```

```
Create a 500€ invoice for the client Dupont
```

```
Show my products
```

<Warning>
  If the authentication window does not open, check that `npx` is available in your terminal and that `mcp-remote` can be installed.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Available tools" icon="wrench" href="/en/tools/factures">
    Discover the 37 tools at your disposal.
  </Card>

  <Card title="Authentication" icon="lock" href="/en/authentication">
    Understand the OAuth flow and security.
  </Card>
</CardGroup>