# Connecter votre assistant

> Ajoutez le serveur MCP CiteMe à Claude, à ChatGPT ou à un autre client MCP, ou installez le paquet local.

Installation

Il vous faut un compte CiteMe dans une organisation **Starter**, **Pro** ou **Expert**, et l'adresse du serveur :

```
https://mcp.citeme.io
```

:::tip Le raccourci depuis CiteMe
Dans un projet, ouvrez **Paramètres > Outils développeur**. La carte **Serveur MCP** propose les boutons **Connecter à Claude** et **Connecter à ChatGPT**, qui ouvrent le bon écran avec l'adresse déjà remplie, ainsi que la configuration à copier pour Cursor, n8n et les autres clients.
:::

---

## Claude

La connexion se fait dans le navigateur, sans clé à copier.

1. Cliquez sur **Connecter à Claude** dans CiteMe. Sinon, ouvrez [la page des connecteurs de Claude](https://claude.ai/customize/connectors), cliquez sur « Add custom connector », nommez le connecteur `CiteMe` et collez l'adresse `https://mcp.citeme.io`.
2. Vérifiez le nom et l'adresse, puis validez l'ajout.
3. Sur la fiche du connecteur, cliquez sur « Connect », puis sur « Sign in now » si Claude le propose. Une page CiteMe s'ouvre : connectez-vous si besoin, vérifiez le nom de l'application qui demande l'accès, puis cliquez sur « Authorize ».
4. Dans une conversation, ouvrez le menu « + », puis « Connectors », et activez **CiteMe**.

:::info Claude Team et Enterprise
Sur ces offres, l'ajout d'un connecteur personnalisé est en général réservé aux propriétaires de l'organisation Claude. Une fois le connecteur ajouté, chaque personne s'y connecte avec son propre compte CiteMe et garde les droits de son propre rôle.
:::

---

## ChatGPT

ChatGPT accepte les serveurs MCP externes en **mode développeur**, disponible sur les forfaits ChatGPT payants et désactivé par défaut.

1. Dans ChatGPT, ouvrez « Settings », puis « Security and login », et activez « Developer mode ».
2. Cliquez sur **Connecter à ChatGPT** dans CiteMe. Dans le formulaire « New Plugin », donnez-lui un nom (`CiteMe`), collez `https://mcp.citeme.io` dans « Connection », cochez « I understand and want to continue », puis cliquez sur « Create ».
3. ChatGPT ouvre la page de connexion CiteMe : connectez-vous si besoin, puis cliquez sur « Authorize ».
4. Dans chaque conversation, activez CiteMe via le menu « + », puis « Developer mode ».

:::note
ChatGPT renomme régulièrement ces menus. Si un libellé a changé, cherchez « Developer mode » et « Connectors » dans les réglages.
:::

---

## Autres clients MCP

Tout client qui parle MCP en **Streamable HTTP** peut se connecter : n8n, un framework d'agents, votre propre code.

| Réglage | Valeur |
|---------|--------|
| URL du serveur | `https://mcp.citeme.io`, ou `https://mcp.citeme.io/api/mcp` si votre client exige un chemin |
| Transport | Streamable HTTP, réponses en JSON |
| Authentification | OAuth 2.1 avec PKCE (`S256`) |
| Scopes | `read`, `write` |

La découverte est automatique. Sans jeton, le serveur répond `401` avec un en-tête `WWW-Authenticate` qui pointe vers ses métadonnées, `https://mcp.citeme.io/.well-known/oauth-protected-resource`. Le serveur d'autorisation est `https://app.citeme.io` : il accepte l'enregistrement dynamique des clients et les documents de métadonnées client (un `client_id` sous forme d'URL HTTPS). Le paramètre `resource` doit être l'URL du serveur MCP.

### Clients sans connexion OAuth

Certains outils, comme n8n, envoient un en-tête fixe au lieu d'ouvrir une connexion dans le navigateur. Utilisez alors la clé que la CLI CiteMe enregistre quand vous vous connectez :

```bash
npm install -g @citeme-io/cli
citeme login
citeme config
```

`citeme config` affiche l'emplacement du fichier de configuration qui contient la clé. Envoyez-la dans l'en-tête `Authorization: Bearer <clé>`. Elle expire au bout de 90 jours : relancez `citeme login` pour en obtenir une nouvelle.

:::caution
Cette clé agit en votre nom, avec tous les droits de votre rôle. Ne la partagez pas et ne la placez pas là où d'autres peuvent la lire, par exemple dans un workflow n8n partagé.
:::

---

## Paquet local (stdio) {#paquet-local}

Certains clients ne lancent que des serveurs MCP installés sur votre machine. Pour eux, CiteMe publie le paquet `@citeme-io/mcp`. Il réutilise la connexion de la CLI : pas de seconde connexion, pas de seconde clé. Il expose ses propres outils (projets, suggestions, thèmes, prompts, workflows) et reprend une partie de ceux du serveur hébergé. Les outils `run_audit`, `list_audits` et `get_audit` sont ceux du serveur hébergé : pour piloter les audits, connectez-vous-y directement. Voir la [CLI](../cli/index.md).

Il faut Node.js 18 ou plus récent.

**1. Connectez la CLI une fois :**

```bash
npm install -g @citeme-io/cli
citeme login
```

**2. Ajoutez le serveur à votre client.**

Pour Claude Desktop (`claude_desktop_config.json`) et Cursor (`.cursor/mcp.json` dans le projet, ou `~/.cursor/mcp.json`) :

```json
{
  "mcpServers": {
    "citeme": {
      "command": "npx",
      "args": ["-y", "@citeme-io/mcp"]
    }
  }
}
```

Pour Claude Code :

```bash
claude mcp add citeme -- npx -y @citeme-io/mcp
```

Le paquet ajoute aussi quelques outils qui lui sont propres, dont ceux des [Actions](../actions/index.md) : `list_workflows`, `run_workflow` et `get_workflow_run`. `run_workflow` lance un de vos workflows tel que vous l'avez configuré, publication sur votre CMS comprise si le workflow en contient une. Ces outils n'existent pas sur le serveur hébergé.

---

**[Exemples de demandes →](./examples.md)**