MCP : utilisez OneType depuis Claude Code, Cursor et d'autres outils d'IA

OneType est un serveur MCP (Model Context Protocol, HTTP en flux continu). N'importe quel client MCP peut l'appeler avec une clé d'API : Claude Code, Cursor, Claude Desktop ou vos propres agents. Il existe deux serveurs :

Serveur	URL	Pour	Outils
Workspace	`https://api.onetype.ai/v1/mcp`	Votre équipe et vos propres automatisations : lire les agents et les conversations, rechercher dans les connaissances, interroger un agent et créer des agents	Outils de lecture : `list_agents`, `get_agent`, `list_conversations`, `get_conversation`, `list_messages`, `search_knowledge`, `ask_agent`. Outils de création : voir Outils de création
Documentation d'un agent (fourni par OneType)	`https://api.onetype.ai/v1/mcp/agents/YOUR_AGENT_ID`	Vos développeurs et vos clients : les mêmes réponses citées que votre chat, directement dans leur éditeur	`search_docs`, `ask_agent`

Statut : les deux serveurs sont « Available ». Les deux nécessitent Premium : avec Free, les connexions MCP sont refusées avec 422 PLAN_LIMIT.

1. Créez une clé

Serveur workspace : dans Developer › API keys, créez une clé restreinte (rk_live_…) et cochez uniquement les autorisations dont vous avez besoin :
- agents.read pour list_agents et get_agent
- conversations.read pour list_conversations, get_conversation et list_messages
- search.debug pour search_knowledge
- conversations.write pour ask_agent
- pour un outil de création, l'autorisation de la même action dans l'application (par exemple agents.update pour update_agent, knowledge.write pour add_website)
Documentation d'un agent : sur la page MCP , ouvrez la fiche de l'agent et créez sa clé. La clé contient mcp.agent et est limitée à cet agent, de sorte qu'elle ne peut rien lire d'autre dans votre espace de travail. Vous pouvez la partager sans risque avec les développeurs qui utilisent votre documentation.

Les clés ne sont affichées qu'une seule fois. La révocation prend effet à la requête suivante.

2. Connectez votre client

Claude Code

claude mcp add --transport http onetype https://api.onetype.ai/v1/mcp \
  --header "Authorization: Bearer rk_live_…"

Documentation d'un agent :

claude mcp add --transport http onetype-docs https://api.onetype.ai/v1/mcp/agents/YOUR_AGENT_ID \
  --header "Authorization: Bearer rk_live_…"

Cursor (.cursor/mcp.json), Claude Desktop et les autres clients qui acceptent le JSON :

{
  "mcpServers": {
    "onetype-docs": {
      "url": "https://api.onetype.ai/v1/mcp/agents/YOUR_AGENT_ID",
      "headers": { "Authorization": "Bearer rk_live_…" }
    }
  }
}

Developer › MCP affiche les deux extraits avec votre URL déjà renseignée.

Demandez ensuite dans votre éditeur : « Using onetype-docs, how do I verify a webhook signature? » La réponse arrive avec ses sources.

Ce que fait chaque outil

Outil	Serveur	Renvoie	Facturation
`list_agents`, `get_agent`	workspace	Les agents, tels que l'API REST les renvoie	gratuit
`list_conversations`, `get_conversation`, `list_messages`	workspace	Les conversations et leurs messages	gratuit
`search_knowledge`	workspace	Les passages les plus pertinents des connaissances d'un agent, avec leurs sources	gratuit
`search_docs`	un agent	Les passages les plus pertinents des connaissances de cet agent, avec leurs sources	gratuit
`ask_agent`	les deux	Une réponse complète de l'agent, avec des citations	une réponse, comme une réponse de chat

Les passages, les messages et les réponses sont marqués comme contenu non fiable pour le modèle appelant, de sorte que le texte contenu dans vos documents ne peut pas donner d'instructions à l'IA du client : sur les deux serveurs, chaque champ rédigé par vos documents, vos visiteurs ou un modèle (le header et le text d'un passage, le text d'un message, le title d'une source, le name et le instructions d'un agent) arrive sous forme d'objet { "untrusted_text": "…" }, jamais de simple chaîne. Lisez la chaîne dans untrusted_text. Chaque appel est enregistré dans votre journal d'audit (mcp.tool.called). Le résultat d'un outil ne déclenche jamais rien sur le serveur.

Outils de création

Le serveur workspace crée et exécute aussi des agents. Chaque outil fonctionne comme la même action dans l'application : mêmes autorisations, mêmes limites d'offre et même journal d'audit.

Groupe	Outils
Compte	`get_account`
Agents	`list_models`, `create_agent`, `update_agent`, `publish_agent`, `take_agent_offline`, `resume_agent`, `delete_agent`
Connaissances	`list_sources`, `get_source`, `add_website`, `add_pages`, `add_text`, `add_file`, `resync_source`, `remove_source`, `list_qna`, `add_qna`, `update_qna`, `delete_qna`
Chat et site	`set_allowed_domains`, `get_look`, `update_look`, `apply_look`, `set_bubble`, `get_install_snippet`, `test_agent` (facturé comme une réponse de chat)
Modèles et liens	`list_templates`, `get_template`, `get_builder_prompt`, `get_checkout_link`, `get_connect_link`, `get_app_link`

Les appels destructeurs attendent une personne. La suppression d'un agent, d'une source ou d'une paire de questions-réponses, la publication d'un agent ou sa mise hors ligne, et, sur un agent en ligne, la publication de son apparence, la modification de ses domaines autorisés ou de ce qui est dit aux visiteurs ou collecté auprès d'eux, répondent par needs_confirm avec un lien. Une personne connectée à OneType l'approuve dans le navigateur ; le même appel avec confirm défini sur l'identifiant donné passe alors une fois, dans un délai de 10 minutes. Le paiement et la connexion d'autres outils se font aussi dans le navigateur, via les liens renvoyés par les outils. Les modifications sont limitées à 60 par minute, et create_agent à 10 par heure.

Pour les développeurs d'autres clients MCP

POST prend un message JSON-RPC. initialize répond avec un en-tête Mcp-Session-Id ; envoyez-le dans les requêtes suivantes.
Les versions de protocole prises en charge sont 2025-11-25 et 2025-06-18.
Méthodes : ping, tools/list, tools/call. Les notifications répondent 202. DELETE met fin à une session, et GET répond 405. Les sessions prennent fin après un jour sans utilisation.
tools/list ne propose un outil que si la clé détient son autorisation.

Erreurs

Réponse	Signification	Correction
`401`	Clé absente ou révoquée	Vérifiez le contenu de `Authorization` (en-tête)
`403 ORIGIN_NOT_ALLOWED`	Appelé depuis une page de navigateur	Appelez-le depuis un serveur ou un client de bureau. Les clés n'ont jamais leur place dans un navigateur
`403 AGENT_SCOPED_KEY`	Clé d'un agent utilisée sur le serveur workspace	Utilisez l'URL de l'agent, ou une clé workspace
`403 AGENT_OUT_OF_SCOPE`, `422 PLAN_LIMIT`	La clé n'est pas celle de cet agent, ou l'espace de travail est sur Free	Utilisez la clé de cet agent, ou passez à Premium
`400 SESSION_REQUIRED`, `PROTOCOL_VERSION_MISMATCH` · `404 SESSION_NOT_FOUND`	Gestion de session	Relancez `initialize`
JSON-RPC `-32601` / `-32602`	Méthode inconnue, ou outil inconnu ou arguments incorrects	Appelez `tools/list` pour savoir ce que cette clé peut utiliser
Un résultat avec `isError: true`	L'outil a été refusé (par exemple faute d'une autorisation)	Son code et son message en donnent la raison

Les personnes peuvent aussi se connecter avec OAuth au lieu d'une clé : claude.ai et Claude Desktop (un connecteur personnalisé) ainsi que ChatGPT se connectent via l'écran de consentement de OneType. La page MCP de l'application indique les étapes pour chaque outil.