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

> Connectez votre compte Klark a votre assistant IA en 30 secondes

## Installation

Choisissez votre client IA et suivez les instructions correspondantes.

<Tabs>
  <Tab title="Claude Desktop">
    ### 1. Ouvrez le fichier de configuration

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

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

    ### 2. Ajoutez le serveur Klark

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

    <Info>
      Claude Desktop ne supporte pas encore nativement les serveurs MCP distants. Le package `mcp-remote` fait le pont entre le protocole stdio et HTTP.
    </Info>

    ### 3. Redemarrez Claude Desktop

    Fermez completement l'application (Cmd+Q) et rouvrez-la. Claude detectera automatiquement le serveur Klark.

    ### 4. Authentifiez-vous

    Votre navigateur s'ouvrira sur la page de consentement Klark. Connectez-vous avec votre email et mot de passe, puis autorisez l'acces.

    <Check>
      Les outils Klark apparaissent dans Claude Desktop (icone marteau). Vous pouvez commencer a les utiliser !
    </Check>
  </Tab>

  <Tab title="Cursor">
    ### 1. Ouvrez les parametres MCP

    Allez dans **Settings** > **MCP Servers** > **Add Server**.

    ### 2. Ajoutez la configuration

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

    ### 3. Authentifiez-vous

    Cursor ouvrira automatiquement votre navigateur pour l'authentification OAuth.

    <Check>
      Les outils Klark sont maintenant disponibles dans Cursor.
    </Check>
  </Tab>

  <Tab title="Claude Code">
    ### 1. Ajoutez le serveur

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

    ### 2. Authentifiez-vous

    Lors de la premiere utilisation d'un outil Klark, votre navigateur s'ouvrira pour l'authentification.

    <Check>
      C'est tout ! Les outils Klark sont prets.
    </Check>
  </Tab>

  <Tab title="Autre client MCP">
    Configurez votre client avec les parametres suivants :

    | Parametre        | Valeur                         |
    | ---------------- | ------------------------------ |
    | URL du serveur   | `https://api.klark.app/v1/mcp` |
    | Transport        | Streamable HTTP                |
    | Authentification | OAuth 2.0 (automatique)        |

    <Info>
      Consultez la documentation de votre client MCP pour savoir comment ajouter un serveur distant.
    </Info>
  </Tab>
</Tabs>

## Tester la connexion

Une fois connecte, essayez ces commandes dans votre assistant IA :

```
Liste mes clients
```

```
Cree une facture de 500€ pour le client Dupont
```

```
Montre mes produits
```

<Warning>
  Si la fenetre d'authentification ne s'ouvre pas, verifiez que `npx` est accessible dans votre terminal et que `mcp-remote` peut etre installe.
</Warning>

## Prochaines etapes

<CardGroup cols={2}>
  <Card title="Outils disponibles" icon="wrench" href="/tools/factures">
    Decouvrez les 37 outils a votre disposition.
  </Card>

  <Card title="Authentification" icon="lock" href="/authentication">
    Comprendre le flow OAuth et la securite.
  </Card>
</CardGroup>