# Connecter Semactic à un agent ou à un autre client MCP

Semactic propose deux serveurs MCP : celui de la **documentation**, ouvert à tous sans compte, et celui de vos **données Semactic**, réservé aux clients (add-on MCP et clé API).

Cette page donne leurs paramètres sous une forme qu'un agent IA ou un client MCP en ligne de commande peut appliquer directement. Pour l'interface de Claude ou de ChatGPT, suivez plutôt [Connecter Semactic à Claude](https://docs.semactic.com/mcp/connect-claude) ou [Connecter Semactic à ChatGPT](https://docs.semactic.com/mcp/connect-chatgpt).

## Documentation : serveur public, sans compte

Le serveur MCP de la documentation est en lecture seule et ne demande ni compte ni clé : `https://docs.semactic.com/mcp/public`.

```bash
claude mcp add --transport http semactic-docs-public https://docs.semactic.com/mcp/public
```

## Données Semactic : paramètres du serveur

| Paramètre | Valeur |
|---|---|
| URL du serveur | `https://mcp.semactic.com/mcp` |
| Transport | HTTP (Streamable HTTP) |
| Authentification | OAuth, code d'autorisation avec PKCE (`S256`) |
| Enregistrement du client | Dynamique : laissez l'identifiant et le secret client OAuth vides |
| Identifiant demandé | Votre clé API Semactic, saisie dans la page d'autorisation |

> [!NOTE]
> Le serveur MCP nécessite l'add-on **MCP**. Votre clé API se trouve sur la carte **Semactic API** de la page **Integration** : voir [API Semactic et serveur MCP](https://docs.semactic.com/integrations/semactic-api).

## Ce que l'agent fait, ce que vous faites

- **L'agent** ajoute le serveur à la configuration de son client MCP et lance l'autorisation.
- **Vous** collez votre clé API dans la page d'autorisation qui s'ouvre dans votre navigateur, puis cliquez sur **Authorize**.

> [!WARNING]
> Ne collez pas votre clé API dans une conversation et ne l'écrivez pas dans un fichier de configuration : saisissez-la uniquement dans la page d'autorisation de Semactic. Toute personne qui possède cette clé peut lire vos données.

## Claude Code

Ajoutez le serveur :

```bash
claude mcp add --transport http semactic https://mcp.semactic.com/mcp
```

Dans Claude Code, tapez ensuite `/mcp`, choisissez **semactic** et lancez l'authentification. Votre navigateur s'ouvre : collez votre clé API et cliquez sur **Authorize**.

## Fichier de configuration JSON

Pour un client qui lit un fichier de configuration (par exemple `.mcp.json` pour Claude Code) :

```json
{
  "mcpServers": {
    "semactic": {
      "type": "http",
      "url": "https://mcp.semactic.com/mcp"
    }
  }
}
```

Le nom exact des champs dépend du client : certains attendent `streamable-http` comme type, d'autres seulement l'URL. Reprenez l'URL et le transport du tableau ci-dessus dans le format de votre client.

## Vérifier la connexion

Demandez à l'agent d'appeler `get_my_account_context`, puis `list_projects` : il doit obtenir votre compte et vos projets. La liste complète des outils est décrite dans [Outils MCP Semactic : vue d'ensemble](https://docs.semactic.com/mcp-tools/overview).

## Si la connexion échoue

- **Le serveur répond 401** : l'autorisation n'a pas été faite ou a expiré. Relancez l'authentification depuis votre client.
- **La clé est refusée** : vérifiez que l'add-on **MCP** est actif et que la clé est la bonne. Après **Rafraîchir la clé**, l'ancienne clé cesse immédiatement de fonctionner.
