> ## 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.

# Connecter les clients

> Connectez Remote ou Local MCP à un client IA compatible.

## Vue d’ensemble

Connectez Claude, ChatGPT Desktop, Codex, Cursor ou VS Code. Préférez Remote sans installation ni gestion de clés ; Local pour fichiers locaux ou environnements sans interface.

## Choisir la connexion

Choisissez selon l’environnement et le besoin de fichiers locaux.

| Méthode | Usage | Authentification | Installation |
| - | - | - | - |
| Remote MCP | Clients IA habituels | OAuth navigateur | Aucune |
| Local MCP | Sans interface ou fichiers locaux | Clé NoimosAI | Node.js et paquet npm |

> [!NOTE]
>
> Remote ne permet pas `upload_media`, `upload_website_source` ni `download_creation` pour les fichiers locaux. Utilisez Local.

## Connexion Remote

Enregistrez l’endpoint NoimosAI puis autorisez l’accès dans le navigateur.

Préparez deux éléments :

* Un compte NoimosAI
* Un client MCP avec Streamable HTTP et OAuth

Utilisez cette URL.

```text theme={null}
https://mcp.noimosai.com/mcp
```

Suivez les instructions de votre client.

> [tab] Claude Code
>
> Dans Claude Code, ajoutez l’endpoint ainsi.
>
> ```bash theme={null}
> claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp
> ```
>
> Exécutez `/mcp` dans la session, autorisez dans le navigateur et revenez.

> [tab] Claude.ai / Desktop
>
> Dans Claude.ai ou Claude Desktop, créez un connecteur personnalisé.
>
> Ouvrez **Settings → Connectors → Add custom connector**, entrez `https://mcp.noimosai.com/mcp`, enregistrez puis connectez-vous et autorisez dans le navigateur.

> [tab] ChatGPT Desktop
>
> Dans ChatGPT Desktop, ajoutez un serveur MCP.
>
> 1. Ouvrez **Settings → MCP servers**, puis **Add server**.
> 2. Définissez nom `NoimosAI`, transport **Streamable HTTP** et URL `https://mcp.noimosai.com/mcp`.
> 3. Enregistrez puis choisissez **Restart**.
> 4. Choisissez **Authenticate** et autorisez dans le navigateur.
>
> Saisissez `/mcp` pour voir les serveurs. Selon le [guide OpenAI actuel](https://learn.chatgpt.com/docs/extend/mcp), ChatGPT Web utilise les outils Remote des plugins installés, pas la configuration locale. Ces étapes directes concernent Desktop.

> [tab] Codex
>
> Dans Codex CLI, ces commandes ajoutent l’endpoint et lancent OAuth.
>
> ```bash theme={null}
> codex mcp add noimosai --url https://mcp.noimosai.com/mcp
> codex mcp login noimosai
> ```
>
> Vérifiez avec `codex mcp list`. ChatGPT Desktop, Codex CLI et l’extension IDE partagent la configuration MCP du même hôte Codex.

> [tab] Cursor
>
> Dans Cursor, ajoutez cette configuration au `.cursor/mcp.json` du projet.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Activez NoimosAI dans les paramètres MCP et terminez l’authentification navigateur.

> [tab] VS Code
>
> Dans VS Code, complétez le `.vscode/mcp.json` de l’espace.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "http",
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Démarrer le serveur lance OAuth dans le navigateur.

Vérifiez compte et autorisation `mcp:tools` au consentement. Reconnectez ensuite et vérifiez les outils.

## Connexion Local

Local lance le paquet npm [`@noimosai/mcp`](https://www.npmjs.com/package/@noimosai/mcp) comme processus enfant du client.

Préparez trois éléments :

* Node.js 20 ou ultérieur
* Un client MCP avec STDIO
* Une clé de l’onglet API des paramètres d’équipe NoimosAI

Remplacez `your-api-key` par votre clé. Ajoutez `NOIMOS_WORKSPACE_ID` uniquement pour fixer l’espace par défaut.

> [!WARNING]
>
> Ne partagez ni ne commitez une configuration contenant des clés. Utilisez une clé habituelle ; les clés Developer Platform `nmp_` sont incompatibles.

> [tab] Claude Code
>
> Dans Claude Code, ajoutez le serveur local ainsi.
>
> ```bash theme={null}
> claude mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env MCP_TOOL_TIMEOUT=900000 \
>   -- npx -y @noimosai/mcp
> ```

> [tab] Claude Desktop
>
> Dans Claude Desktop, complétez `claude_desktop_config.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Codex
>
> Dans Codex CLI, ajoutez le serveur local ainsi.
>
> ```bash theme={null}
> codex mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
>   -- npx -y @noimosai/mcp
> ```
>
> Cette commande autorise transferts uniquement dans son dossier d’exécution.

> [tab] Cursor
>
> Dans Cursor, complétez `.cursor/mcp.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Dans VS Code, complétez `.vscode/mcp.json`.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "stdio",
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

Variables d’environnement disponibles :

| Variable | Obligatoire | Description |
| - | - | - |
| `NOIMOS_API_KEY` | Oui | Clé de l’onglet API des paramètres d’équipe. |
| `NOIMOS_WORKSPACE_ID` | Non | Espace par défaut si l’appel omet `workspaceId`. |
| `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` | Non | Dossiers locaux autorisés ; séparez plusieurs chemins avec le séparateur du système. |

Limitez aux dossiers nécessaires. Pour le dossier courant, donnez son chemin absolu à `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` dans la configuration.

Redémarrez le client et vérifiez les outils. `chat` et `create_workspace_and_onboard` peuvent durer plusieurs minutes ; prévoyez environ 15 minutes si le délai est configurable.

## Essayer les premiers outils

Commencez en lecture seule pour vérifier espace et informations sans risque de modification.

Demandez dans cet ordre :

1. « Liste les espaces NoimosAI accessibles. »
2. « Vérifie la marque et les comptes connectés de l’espace cible. »
3. « Rédige un brouillon LinkedIn avec ces informations. Affiche le texte sans publier. »

Les deux premières demandes utilisent `list_workspaces` et `get_workspace_context`, entre autres lectures. La troisième ne publie pas non plus : vérifiez le contenu avant la suite.

## Résoudre les problèmes

Vérifiez selon la connexion :

* **Consentement Remote absent** — Retirez puis recréez la connexion.
* **Outils Remote absents** — Vérifiez `mcp:tools` et l’existence d’un espace.
* **Jeton Remote expiré** — Réautorisez depuis le client.
* **Local ne démarre pas** — Vérifiez Node.js 20+, `npx`, paquet et clé.
* **Espace Local introuvable** — Vérifiez `NOIMOS_WORKSPACE_ID` ou `workspaceId` de l’appel.
* **Fichier local inaccessible** — Vérifiez le dossier autorisé par `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`.

## Pages associées

Ces pages expliquent outils et autres accès.

* [Utiliser les outils](https://docs.noimosai.com/fr/developers/mcp/tools.md)
* [Comprendre les bases](https://docs.noimosai.com/fr/developers/cli/overview.md)
* [Guide standard de connexion MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.