Connecter d’autres clients MCP

En plus de Claude et ChatGPT, tout client MCP qui prend en charge les serveurs distants via HTTP et la connexion OAuth fonctionne – par exemple des IDE comme Cursor, ou MCP Inspector pour les tests. Cet article s’adresse à celles et ceux qui configurent eux-mêmes un tel client ou développent leur propre intégration.

#Informations clés

URL du serveur

https://dock.at-harbor.com/mcp

Transport

Streamable HTTP, sans état. Chaque requête est un POST avec un message JSON-RPC (ou un lot), et la réponse revient en JSON. Il n’y a pas d’ID de session ni de flux serveur.

Versions du protocole

2025-11-25, 2025-06-18 et 2025-03-26

Méthodes

initialize, ping, tools/list et tools/call. Le serveur ne propose ni resources ni prompts.

Connexion

OAuth 2.1 avec PKCE (S256). Sans jeton, le serveur répond 401 et renvoie vers ses métadonnées dans l’en-tête WWW-Authenticate.

#Configurer un client

1. Dans votre client, ajoutez un serveur MCP distant (souvent appelé « Remote », « HTTP » ou « Streamable HTTP »)
2. Saisissez https://dock.at-harbor.com/mcp comme URL
3. Laissez vides le client ID et le secret – le client s’enregistre lui-même
4. Lancez la connexion ; la connexion s’ouvre dans votre navigateur, suivie de la page de consentement LinkHarbor
5. Choisissez l’espace de travail et les droits et cliquez sur « Autoriser »

Le nom du réglage varie d’un programme à l’autre. Dans MCP Inspector, par exemple, vous choisissez le transport « Streamable HTTP ».

#Le flux OAuth en détail

1. Le client appelle le serveur MCP sans jeton et reçoit 401 avec un renvoi vers les métadonnées de la ressource
2. Il lit les métadonnées du serveur d’autorisation (endpoints, méthodes prises en charge, droits)
3. Il s’enregistre : via Dynamic Client Registration ou avec un document de métadonnées client à une URL https
4. Il ouvre le navigateur avec la requête d’autorisation, y compris PKCE et resource=https://dock.at-harbor.com/mcp
5. Vous vous connectez et décidez sur la page de consentement
6. Le client échange le code contre un jeton d’accès et un jeton de rafraîchissement

Si un client ne demande aucun droit, tous sont demandés ; vous pouvez toujours les restreindre sur la page de consentement. Si un jeton de rafraîchissement déjà remplacé est réutilisé, LinkHarbor met fin à toute la connexion pour des raisons de sécurité.

#Règles pour les adresses de redirection

• Adresses https
• http uniquement pour les adresses loopback sur votre propre ordinateur (pour les clients de bureau et les IDE)
• Schémas d’app personnalisés en notation de domaine inversée
• Au maximum 10 adresses par client, sans fragments

Si une application envoie une adresse qui n’est pas enregistrée pour elle, LinkHarbor s’arrête : « L’application a envoyé une adresse de retour qui n’est pas enregistrée pour elle. La demande a été arrêtée. »

#Adresses de découverte pour les développeurs

#Applications inconnues

Les applications dont toutes les adresses de redirection se trouvent sur claude.ai, claude.com, chatgpt.com ou openai.com sont considérées comme connues. Les programmes de votre propre ordinateur qui reviennent via localhost – comme Claude Code, Codex et les IDE – affichent sur la page de consentement la mention « LinkHarbor ne connaît pas cette application. Elle s’exécute sur votre propre ordinateur. Ne continuez que si vous venez de la lancer vous-même. » et, en bas, « Après votre choix, vous revenez à l’application sur votre ordinateur. » Les autres applications web inconnues affichent « LinkHarbor ne connaît pas cette application. Ne continuez que si vous l’avez lancée vous-même et faites confiance à … », avec leur adresse à la place des points de suspension. Les deux mentions sont normales si vous venez de configurer le client vous-même. Un logo n’apparaît que si l’application en envoie un. Si vous n’avez pas lancé la connexion vous-même, cliquez sur « Refuser ».