> ## Documentation Index > Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt > Use this file to discover all available pages before exploring further. # Serveur MCP NoimosAI > Utilisez NoimosAI depuis Claude, ChatGPT, Cursor et les autres clients compatibles MCP. ## Aperçu Le serveur MCP NoimosAI expose votre espace de travail NoimosAI via le [Model Context Protocol](https://modelcontextprotocol.io). Une fois connecté, un client compatible MCP peut discuter avec l’agent NoimosAI, lister les espaces de travail et les intégrations, et publier des posts sociaux directement depuis le client. Deux modes de connexion : * **Remote MCP (recommandé)** — Hébergé sur `https://mcp.noimosai.com/mcp`. OAuth navigateur, sans installation, exécuté en votre nom. * **Local MCP (`@agos-labs/noimosai-mcp`)** — Exécuter le serveur localement via npm. Adapté aux flux sans navigateur / avec clé API. Endpoint : `https://mcp.noimosai.com/mcp` ### Prérequis * Un compte NoimosAI (connecté) * Un client compatible Remote MCP / Custom Connectors ### Autorisation Le client s’enregistre seul, puis un navigateur s’ouvre pour la connexion NoimosAI et la validation du scope `mcp:tools`. Après consentement, un jeton d’accès est émis et les appels d’outils s’exécutent en votre nom. ### Connexion ```bash theme={null} claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp ``` Dans la session, lancez `/mcp`, validez le consentement dans le navigateur puis revenez à Claude Code. Settings → Connectors → **Add custom connector** → URL `https://mcp.noimosai.com/mcp` → connectez-vous et validez le consentement dans le navigateur. Ajoutez un Custom MCP connector avec l’URL `https://mcp.noimosai.com/mcp` puis validez le consentement. ChatGPT ne détecte pas automatiquement les outils `search` / `fetch` génériques — appelez les outils NoimosAI par leur nom. ### Notes * Appelez toujours `post` d’abord avec `dryRun: true` pour vérifier le payload. Sans `dryRun`, les posts sont publiés sur le vrai compte social. * Pour déconnecter, supprimez le connector depuis le client. ### Dépannage * **Le navigateur ne s’ouvre pas pour le consentement** — supprimez puis ré-ajoutez le connector. * **Aucun outil listé** — vérifiez que le scope `mcp:tools` a été accordé et que le compte possède au moins un espace de travail. * **Jeton expiré** — réautorisez depuis le client. Publié sur npm sous [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@agos-labs/noimosai-mcp). Exécuté comme processus enfant du client. ### Prérequis * Node.js `>= 18` * Un client compatible MCP (Claude Desktop, Cursor, VS Code, …) * Une clé API NoimosAI depuis les paramètres d’équipe ### Configuration Remplacez `your-api-key` et `your-workspace-id` par les valeurs de votre équipe NoimosAI. Ajoutez dans `claude_desktop_config.json` : ```json theme={null} { "mcpServers": { "noimosai": { "command": "npx", "args": ["-y", "@agos-labs/noimosai-mcp"], "env": { "NOIMOS_API_KEY": "your-api-key", "NOIMOS_WORKSPACE_ID": "your-workspace-id" } } } } ``` Ajoutez dans `.cursor/mcp.json` : ```json theme={null} { "mcpServers": { "noimosai": { "command": "npx", "args": ["-y", "@agos-labs/noimosai-mcp"], "env": { "NOIMOS_API_KEY": "your-api-key", "NOIMOS_WORKSPACE_ID": "your-workspace-id" } } } } ``` Ajoutez dans `.vscode/mcp.json` : ```json theme={null} { "servers": { "noimosai": { "command": "npx", "args": ["-y", "@agos-labs/noimosai-mcp"], "env": { "NOIMOS_API_KEY": "your-api-key", "NOIMOS_WORKSPACE_ID": "your-workspace-id" } } } } ``` Redémarrez le client après modification de la configuration pour qu’il charge le serveur MCP. ### Variables d’environnement | Variable | Obligatoire | Description | | --------------------- | ----------- | ------------------------------------------------------------------------ | | `NOIMOS_API_KEY` | Oui | Clé API NoimosAI (disponible dans l’onglet API des paramètres d’équipe). | | `NOIMOS_WORKSPACE_ID` | Non | ID d’espace par défaut quand un appel omet `workspaceId`. | ## Outils Les deux transports exposent les mêmes outils. ### `chat` Envoie un message à l’agent NoimosAI. Renvoie un NoimosPostJson structuré contenant la réponse de l’agent et les posts sociaux extraits. Convient à l’analyse marketing, à la création de posts sociaux, au SEO et à la génération de contenu. | Paramètre | Type | Obligatoire | Description | | ------------- | -------- | ----------- | -------------------------------------------------------------------------------------------- | | `prompt` | `string` | Oui | Message ou instruction envoyé à l’agent. | | `workspaceId` | `string` | Non | ID de l’espace. Par défaut `NOIMOS_WORKSPACE_ID` (Local) ou l’espace du compte autorisé. | | `sessionId` | `string` | Non | ID de session pour poursuivre une conversation. Sans valeur, une nouvelle session est créée. | ### `list_workspaces` Liste les espaces de travail disponibles avec leur ID et leur nom. Aucun paramètre. ### `list_integrations` Liste les intégrations connectées (comptes sociaux) de l’espace de travail. Renvoie les IDs de compte (`providerAccountId`) requis par l’outil `post` pour chaque entrée. ### `post` Publie des posts sociaux. Accepte les données NoimosPostJson renvoyées par `chat`. Chaque entrée doit inclure `providerAccountId` (récupérez-le via `list_integrations`). Commencez toujours par `dryRun: true` pour vérifier le payload avant la publication. | Paramètre | Type | Obligatoire | Description | | ------------- | --------- | ----------- | ------------------------------------------------------------------------------------------ | | `posts` | `array` | Oui | Tableau de posts au format NoimosPostJson. Chaque entrée requiert `providerAccountId`. | | `schedule` | `string` | Oui | Horaire de publication. `"now"` pour immédiat ou `"YYYY-MM-DD HH:MM"` pour planifié. | | `workspaceId` | `string` | Non | ID de l’espace. Par défaut l’espace par défaut. | | `dryRun` | `boolean` | Non | Si `true`, affiche le contenu qui serait envoyé sans publier. Valeur par défaut : `false`. | ## En rapport * [Qu'est-ce que NoimosAI ?](/fr/help-center/getting-started/what-is-noimosai) * [NoimosAI CLI](/fr/developers/cli/overview) * [Paquet npm](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)