Connecter le serveur MCP

Votre token MCP connecte votre outil d'IA à un seul site web. Les applications (Claude, ChatGPT) prennent le token dans l'URL. Les outils de code (Claude Code, Cursor…) le prennent dans un en-tête Authorization: Bearer.

Récupérez votre token

1. Ouvrez le tableau de bord sur /app/tokens.
2. Copiez votre token MCP.

Un token = un site web. Pour 3 sites web, ajoutez 3 connecteurs.

Deux façons d'envoyer le token

Pourquoi deux façons ? Les connecteurs de Claude et de ChatGPT ne peuvent pas envoyer d'en-têtes personnalisés. Le token va donc dans l'URL.

Claude (applications web, bureau et mobile)

https://mcp.flocon-ai.com/<token>

Un connecteur ajouté sur le web marche aussi dans les applications de bureau et mobile.

ChatGPT

https://mcp.flocon-ai.com/<token>

Claude Code

Lancez ceci dans votre terminal :

claude mcp add --transport http flocon-ai https://mcp.flocon-ai.com --header "Authorization: Bearer <token>"

Ajoutez --scope user pour l'utiliser dans tous vos projets.

Ou partagez-le avec votre équipe dans .mcp.json à la racine du projet. Chacun définit FLOCON_MCP_TOKEN dans son terminal, et le token reste hors de git :

{
"mcpServers": {
  "flocon-ai": {
    "type": "http",
    "url": "https://mcp.flocon-ai.com",
    "headers": {
      "Authorization": "Bearer ${FLOCON_MCP_TOKEN}"
    }
  }
}
}

Demandez ensuite à Claude Code : « Appelle get_website de Flocon AI. »

Cursor

Ajoutez ceci à .cursor/mcp.json (ou à votre ~/.cursor/mcp.json global) :

{
"mcpServers": {
  "flocon-ai": {
    "url": "https://mcp.flocon-ai.com",
    "headers": {
      "Authorization": "Bearer <token>"
    }
  }
}
}

Demandez ensuite à Cursor : « Appelle get_website de Flocon AI. »

VS Code (GitHub Copilot)

Ajoutez ceci à .vscode/mcp.json. VS Code demande le token la première fois et le garde en sécurité. Attention : la clé du haut est servers, pas mcpServers.

{
"inputs": [
  {
    "type": "promptString",
    "id": "flocon-token",
    "description": "Flocon AI MCP token",
    "password": true
  }
],
"servers": {
  "flocon-ai": {
    "type": "http",
    "url": "https://mcp.flocon-ai.com",
    "headers": {
      "Authorization": "Bearer ${input:flocon-token}"
    }
  }
}
}

Ensuite, dans Copilot Chat (mode Agent), demandez : « Appelle get_website de Flocon AI. »

Windsurf

Ajoutez ceci à ~/.codeium/windsurf/mcp_config.json (Cascade → MCPs → View raw config). Windsurf utilise serverUrl, pas url.

{
"mcpServers": {
  "flocon-ai": {
    "serverUrl": "https://mcp.flocon-ai.com",
    "headers": {
      "Authorization": "Bearer <token>"
    }
  }
}
}

Rafraîchissez la liste des MCP dans Cascade. Puis demandez : « Appelle get_website de Flocon AI. »

Codex (OpenAI)

Codex lit le token dans une variable d'environnement. Il ne l'écrit jamais sur le disque.

export FLOCON_MCP_TOKEN="<token>"
codex mcp add flocon-ai --url https://mcp.flocon-ai.com --bearer-token-env-var FLOCON_MCP_TOKEN

Cela ajoute le serveur dans ~/.codex/config.toml. Mettez la ligne export dans votre profil (~/.zshrc ou ~/.bashrc) pour qu'elle soit toujours définie. Vérifiez avec /mcp dans Codex.

Gemini CLI

Ajoutez ceci à ~/.gemini/settings.json (ou à .gemini/settings.json dans votre projet) :

{
"mcpServers": {
  "flocon-ai": {
    "httpUrl": "https://mcp.flocon-ai.com",
    "headers": {
      "Authorization": "Bearer <token>"
    }
  }
}
}

Relancez Gemini CLI. Vérifiez avec /mcp.

Votre propre agent (Claude Agent SDK)

Passez le serveur dans mcpServers. Gardez le token dans une variable d'environnement :

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
prompt: "Call get_website from Flocon AI.",
options: {
  mcpServers: {
    "flocon-ai": {
      type: "http",
      url: "https://mcp.flocon-ai.com",
      headers: { Authorization: `Bearer ${process.env.FLOCON_MCP_TOKEN}` },
    },
  },
},
})) {
console.log(message);
}

Un autre outil ?

Tout client MCP qui parle Streamable HTTP marche :

• Il peut envoyer des en-têtes → URL https://mcp.flocon-ai.com + en-tête Authorization: Bearer <token>.
• Il ne peut pas envoyer d'en-têtes → URL https://mcp.flocon-ai.com/<token>, sans authentification.

Ce que vous devez voir

get_website renvoie le nom de votre site web, ses langues, votre offre et le nombre de pages. Si c'est le cas, vous êtes connecté.

Dépannage

• Erreur 401 : le token est faux ou a été renouvelé. Copiez le nouveau token depuis /app/tokens.
• Erreur 401 avec « This is a website token (FLOCON_TOKEN). Your AI tool needs the MCP token » : vous avez collé le token du site web. Copiez le token MCP depuis /app/tokens.
• Claude ou ChatGPT n'arrive pas à se connecter, ou vous demande de vous connecter : vous avez utilisé https://mcp.flocon-ai.com sans le token. Utilisez https://mcp.flocon-ai.com/<token>.
• L'en-tête est ignoré : vérifiez le mot Bearer et l'espace avant le token : Bearer <token>.
• Mauvais site web : chaque token appartient à un site web. Utilisez le token du site web voulu.
• N'utilisez pas le token du site web. Il sert à votre site web (FLOCON_TOKEN). Le MCP le refuse.

Suite : Écrire de bonnes pages.

Mis à jour 31 octobre 2026