Connectez Claude, Claude Code, ChatGPT, Cursor, VS Code ou Codex à votre espace de travail AmICited via MCP. Une seule URL, une connexion OAuth, et une clé API en solution de repli.
AmICited exploite un serveur MCP (Model Context Protocol) toujours actif. Une fois votre client IA connecté, il peut lire vos données de visibilité, exécuter des rapports et, avec l’accès en écriture, ajouter des prompts, générer des articles ou consigner des annotations, le tout depuis une conversation normale. Chaque fonctionnalité du tableau de bord existe aussi sous forme d’outil MCP : il n’y a donc rien que vous puissiez faire dans l’application qu’un agent ne puisse pas faire.
Une offre qui inclut MCP. MCP est disponible pendant l’essai de 7 jours et sur Pro, Premium et Enterprise. Les espaces de travail Starter peuvent voir l’URL du serveur, mais les connexions sont refusées tant que l’offre n’est pas mise à niveau. Voir offres et limites.
Des droits Editor ou supérieurs dans l’espace de travail. La page MCP indique aux membres qui n’en disposent pas de s’adresser à un propriétaire ou à un administrateur de l’espace de travail.
Un solde de crédits positif. Les lectures via MCP sont gratuites, mais le point de terminaison vérifie que l’espace de travail a des crédits avant de répondre. Voir crédits.
L’espace de travail ne figure pas dans l’URL. Il provient de votre identifiant : avec OAuth, vous choisissez l’espace de travail sur l’écran de consentement, et une clé API appartient déjà à un seul espace de travail. Vous pouvez aussi copier l’URL depuis la page MCP de l’application, qui l’affiche avec un bouton Copy URL et les mêmes instructions par client que ci-dessous. Le transport est du streamable HTTP.
Collez https://api.flowhunt.io/mcp/amicited et cliquez sur Add.
Cliquez sur Connect sur le nouveau connecteur et approuvez l’accès dans la fenêtre de navigateur qui s’ouvre. Choisissez votre espace de travail sur l’écran de consentement.
Dans une conversation, ouvrez le menu des outils et vérifiez que le connecteur AmICited est activé.
Alternative avec clé API (fichier de configuration de Claude Desktop). Ajoutez ceci sous mcpServers dans ~/Library/Application Support/Claude/claude_desktop_config.json sur macOS, puis redémarrez Claude Desktop :
Les connecteurs MCP personnalisés nécessitent le Developer mode, disponible sur les offres ChatGPT payantes (Plus, Pro, Team, Enterprise). Dans les espaces de travail Business, Enterprise et Edu, un administrateur peut devoir l’activer pour vous.
Dans ChatGPT, ouvrez Settings, puis Apps & Connectors.
Ajoutez un connecteur personnalisé et collez https://api.flowhunt.io/mcp/amicited.
Approuvez l’accès dans la fenêtre de navigateur qui s’ouvre.
Alternative avec clé API. À l’étape 4, choisissez plutôt l’authentification par clé API et collez la clé API de votre espace de travail. Enregistrez le connecteur, puis activez-le dans une nouvelle conversation.
Cursor
Sur la page MCP de l’application, sélectionnez Cursor et cliquez sur Add to Cursor. Cursor installe le serveur et lance la connexion pour vous.
Si le bouton n’ouvre pas Cursor, ajoutez le serveur à la main dans les paramètres de Cursor sous MCP, ou modifiez ~/.cursor/mcp.json (ou un .cursor/mcp.json propre au projet) :
Alternative avec clé API. Ajoutez "headers": { "Authorization": "Bearer <your-workspace-api-key>" } à l’entrée. Vous pouvez aussi exécuter MCP: Add Server…, choisir HTTP (HTTP or Server-Sent Events), coller l’URL et ajouter l’en-tête Authorization quand cela vous est demandé.
Codex
Codex se connecte comme un client MCP distant standard. Ajoutez le serveur, puis connectez-vous :
Collez l’URL plus un en-tête Authorization: Bearer
Espace de travail
Choisi sur l’écran de consentement
Fixé par la clé
Autorisations
amicited:read pour se connecter et lire ; amicited:write en plus pour écrire
Accès complet à l’espace de travail
Révocation
Connected clients → Revoke sur la page MCP
Supprimez ou faites expirer la clé
OAuth est le meilleur choix par défaut : il n’y a aucun secret à coller dans un fichier de configuration, chaque client apparaît par son nom sur la page MCP sous Connected clients, et vous pouvez en révoquer un sans toucher aux autres. Un jeton OAuth en lecture seule peut tout lister et tout lire, mais tout outil qui crée, modifie ou supprime refusera avec un message nommant le scope amicited:write. Réessayer n’aidera pas ; reconnectez-vous avec l’accès en écriture.
Traitez une clé API comme un mot de passe
Toute personne détenant une clé API d’espace de travail peut exécuter chaque outil du serveur sur les données de votre espace de travail, y compris en écriture. Préférez OAuth, gardez les clés hors des dépôts partagés, et utilisez une variable d’environnement lorsque votre client le permet.
Demandez quelque chose de simple à votre agent : « Liste mes domaines AmICited. » Il doit appeler list_domains et renvoyer vos domaines par leur nom. Essayez ensuite « Montre ma visibilité IA sur les 30 derniers jours », qui utilise prompt_analytics.
Si la connexion est refusée, le message en indique généralement la raison :
Offre. « requires a Pro plan or above » : l’offre du propriétaire de l’espace de travail n’inclut pas MCP.
Crédits. Le solde de l’espace de travail est nul ou négatif. Rechargez et réessayez.
Limite de débit. Les appels d’outils sont plafonnés par espace de travail et par heure : 120 pendant l’essai, 600 sur Pro, 2 000 sur Premium, illimité sur Enterprise. Le message indique quand la fenêtre se réinitialise. Lister les outils et lire les skills ne compte pas.
# Connecter le serveur MCP
Connectez Claude, Claude Code, ChatGPT, Cursor, VS Code ou Codex à votre espace de travail AmICited via MCP. Une seule URL, une connexion OAuth, et une clé API en solution de repli.
AmICited exploite un serveur MCP (Model Context Protocol) toujours actif. Une fois votre client IA connecté, il peut lire vos données de visibilité, exécuter des rapports et, avec l'accès en écriture, ajouter des prompts, générer des articles ou consigner des annotations, le tout depuis une conversation normale. Chaque fonctionnalité du tableau de bord existe aussi sous forme d'outil MCP : il n'y a donc rien que vous puissiez faire dans l'application qu'un agent ne puisse pas faire.
## Avant de commencer
- **Une offre qui inclut MCP.** MCP est disponible pendant l'essai de 7 jours et sur Pro, Premium et Enterprise. Les espaces de travail Starter peuvent voir l'URL du serveur, mais les connexions sont refusées tant que l'offre n'est pas mise à niveau. Voir [offres et limites](/docs/account/plans-and-limits/).
- **Des droits Editor ou supérieurs** dans l'espace de travail. La page **MCP** indique aux membres qui n'en disposent pas de s'adresser à un propriétaire ou à un administrateur de l'espace de travail.
- **Un solde de crédits positif.** Les lectures via MCP sont gratuites, mais le point de terminaison vérifie que l'espace de travail a des crédits avant de répondre. Voir [crédits](/docs/account/credits/).
## L'URL du serveur
Il existe une seule URL pour tout le monde :
```text
https://api.flowhunt.io/mcp/amicited
```
L'espace de travail ne figure pas dans l'URL. Il provient de votre identifiant : avec OAuth, vous choisissez l'espace de travail sur l'écran de consentement, et une clé API appartient déjà à un seul espace de travail. Vous pouvez aussi copier l'URL depuis la page **MCP** de l'application, qui l'affiche avec un bouton **Copy URL** et les mêmes instructions par client que ci-dessous. Le transport est du streamable HTTP.
## Connecter votre client
Choisissez votre client. Chaque onglet commence par la connexion OAuth recommandée et se termine par l'alternative avec clé API.
Les connecteurs que vous ajoutez sur claude.ai sont aussi disponibles dans l'application Claude Desktop.
1. Ouvrez les [paramètres des connecteurs de Claude](https://claude.ai/customize/connectors).
2. Cliquez sur **+**, puis sur **Add custom connector**.
3. Collez `https://api.flowhunt.io/mcp/amicited` et cliquez sur **Add**.
4. Cliquez sur **Connect** sur le nouveau connecteur et approuvez l'accès dans la fenêtre de navigateur qui s'ouvre. Choisissez votre espace de travail sur l'écran de consentement.
Dans une conversation, ouvrez le menu des outils et vérifiez que le connecteur AmICited est activé.
**Alternative avec clé API (fichier de configuration de Claude Desktop).** Ajoutez ceci sous `mcpServers` dans `~/Library/Application Support/Claude/claude_desktop_config.json` sur macOS, puis redémarrez Claude Desktop :
```json {title="claude_desktop_config.json"}
{
"mcpServers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited",
"headers": {
"Authorization": "Bearer <your-workspace-api-key>"
}
}
}
}
```
Enregistrez le serveur une seule fois depuis votre terminal :
```bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited
```
Exécutez ensuite `/mcp` dans Claude Code, choisissez **Authenticate**, et approuvez l'accès dans la fenêtre de navigateur qui s'ouvre.
**Alternative avec clé API.** Ajoutez le serveur sous la clé de premier niveau `mcpServers` dans `~/.claude.json` et redémarrez Claude Code :
```json {title="~/.claude.json"}
{
"mcpServers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited",
"headers": {
"Authorization": "Bearer <your-workspace-api-key>"
}
}
}
}
```
Les connecteurs MCP personnalisés nécessitent le **Developer mode**, disponible sur les offres ChatGPT payantes (Plus, Pro, Team, Enterprise). Dans les espaces de travail Business, Enterprise et Edu, un administrateur peut devoir l'activer pour vous.
1. Activez le Developer mode comme décrit dans la [documentation des connecteurs d'OpenAI](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt).
2. Dans ChatGPT, ouvrez **Settings**, puis **Apps & Connectors**.
3. Ajoutez un connecteur personnalisé et collez `https://api.flowhunt.io/mcp/amicited`.
4. Approuvez l'accès dans la fenêtre de navigateur qui s'ouvre.
**Alternative avec clé API.** À l'étape 4, choisissez plutôt l'authentification par clé API et collez la clé API de votre espace de travail. Enregistrez le connecteur, puis activez-le dans une nouvelle conversation.
Sur la page **MCP** de l'application, sélectionnez **Cursor** et cliquez sur **Add to Cursor**. Cursor installe le serveur et lance la connexion pour vous.
Si le bouton n'ouvre pas Cursor, ajoutez le serveur à la main dans les paramètres de Cursor sous MCP, ou modifiez `~/.cursor/mcp.json` (ou un `.cursor/mcp.json` propre au projet) :
```json {title="~/.cursor/mcp.json"}
{
"mcpServers": {
"amicited": {
"url": "https://api.flowhunt.io/mcp/amicited"
}
}
}
```
Cursor ouvre un navigateur pour la connexion la première fois qu'il se connecte. Passez la conversation en mode **Agent** pour utiliser les outils.
**Alternative avec clé API.** Ajoutez un en-tête à la même entrée :
```json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }
```
VS Code utilise le serveur via **GitHub Copilot en mode Agent** : Copilot doit donc être activé.
Sur la page **MCP** de l'application, sélectionnez **VS Code** et cliquez sur **Add to VS Code**. VS Code installe le serveur et lance la connexion pour vous.
Pour l'ajouter à la main, ouvrez la palette de commandes, exécutez **MCP: Open User Configuration**, et ajoutez le serveur sous `servers` :
```json {title="mcp.json"}
{
"servers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited"
}
}
}
```
**Alternative avec clé API.** Ajoutez `"headers": { "Authorization": "Bearer <your-workspace-api-key>" }` à l'entrée. Vous pouvez aussi exécuter **MCP: Add Server...**, choisir **HTTP (HTTP or Server-Sent Events)**, coller l'URL et ajouter l'en-tête `Authorization` quand cela vous est demandé.
Codex se connecte comme un client MCP distant standard. Ajoutez le serveur, puis connectez-vous :
```bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited
```
Ou modifiez directement `~/.codex/config.toml` :
```toml {title="~/.codex/config.toml"}
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"
```
**Alternative avec clé API.** Placez la clé dans une variable d'environnement et indiquez-la à Codex :
```toml {title="~/.codex/config.toml"}
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"
```
Codex exécuté avec des paramètres d'approbation stricts atteindra tout de même chaque outil en lecture seule via `read_tool`. Voir [toolsets et outils](/docs/mcp/toolsets/).
## OAuth ou clé API
| | OAuth 2.1 (recommandé) | Clé API de l'espace de travail (repli) |
|---|---|---|
| **Configuration** | Collez l'URL, approuvez dans le navigateur | Collez l'URL plus un en-tête `Authorization: Bearer` |
| **Espace de travail** | Choisi sur l'écran de consentement | Fixé par la clé |
| **Autorisations** | `amicited:read` pour se connecter et lire ; `amicited:write` en plus pour écrire | Accès complet à l'espace de travail |
| **Révocation** | **Connected clients → Revoke** sur la page MCP | Supprimez ou faites expirer la clé |
OAuth est le meilleur choix par défaut : il n'y a aucun secret à coller dans un fichier de configuration, chaque client apparaît par son nom sur la page **MCP** sous **Connected clients**, et vous pouvez en révoquer un sans toucher aux autres. Un jeton OAuth en lecture seule peut tout lister et tout lire, mais tout outil qui crée, modifie ou supprime refusera avec un message nommant le scope `amicited:write`. Réessayer n'aidera pas ; reconnectez-vous avec l'accès en écriture.
Toute personne détenant une clé API d'espace de travail peut exécuter chaque outil du serveur sur les données de votre espace de travail, y compris en écriture. Préférez OAuth, gardez les clés hors des dépôts partagés, et utilisez une variable d'environnement lorsque votre client le permet.
## Vérifier que ça marche
Demandez quelque chose de simple à votre agent : *« Liste mes domaines AmICited. »* Il doit appeler `list_domains` et renvoyer vos domaines par leur nom. Essayez ensuite *« Montre ma visibilité IA sur les 30 derniers jours »*, qui utilise `prompt_analytics`.
Si la connexion est refusée, le message en indique généralement la raison :
- **Offre.** « requires a Pro plan or above » : l'offre du propriétaire de l'espace de travail n'inclut pas MCP.
- **Crédits.** Le solde de l'espace de travail est nul ou négatif. Rechargez et réessayez.
- **Limite de débit.** Les appels d'outils sont plafonnés par espace de travail et par heure : 120 pendant l'essai, 600 sur Pro, 2 000 sur Premium, illimité sur Enterprise. Le message indique quand la fenêtre se réinitialise. Lister les outils et lire les skills ne compte pas.
## À lire aussi
Comment un agent trouve le bon outil parmi plus de 300 sans tous les charger.Des prompts à copier-coller pour les briefings, les baisses, les écarts et les articles.Les playbooks intégrés que les agents lisent avant les questions à plusieurs étapes.Quelles offres incluent MCP et ce que chacune autorise.
Source: https://www.amicited.com/fr/docs/mcp/connect/
Esc
↑↓ naviguer↵ ouvrir
Consentement aux Cookies Nous utilisons des cookies pour améliorer votre expérience de navigation et analyser notre trafic. Politique de confidentialité.
Paramètres des Cookies
Cookies Nécessaires
Ces cookies sont nécessaires pour le fonctionnement du site web et ne peuvent pas être désactivés.
Cookies d'Analyse
Ces cookies nous aident à comprendre comment les visiteurs interagissent avec notre site web.
Cookies Marketing
Ces cookies sont utilisés pour mesurer l'efficacité de nos campagnes publicitaires et pour soutenir une publicité pertinente sur des plateformes tierces.
Cookies Fonctionnels
Ces cookies sont utilisés pour mémoriser vos préférences et améliorer votre expérience.