Serveur MCP de la plateforme
Polylane fait tourner un serveur Model Context Protocol à l'adresse https://mcp.polylane.com/mcp en streamable HTTP. Connecte n'importe quel client MCP et ton agent peut interroger la télémétrie, la topologie, le code et les issues sans quitter ton éditeur.
Ce que ça fait
Le serveur expose l'API REST de Polylane, les mêmes outils d'agent que les agents de Polylane utilisent sur chaque fournisseur connecté du catalogue. La carte serveur à https://mcp.polylane.com/.well-known/mcp liste chaque outil. Une fois connecté, demande à ton agent quelque chose comme « Utilise Polylane pour me montrer le taux d'erreur du service que cette branche déploie, sur la dernière heure. »
Outils
| Outil | Description |
|---|---|
search | Interroge la spécification OpenAPI de Polylane depuis une petite fonction asynchrone qui s'exécute dans un bac à sable sur une copie résolue de la spécification. Lecture seule. |
execute | Appelle l'API REST via codemode.request({ method, path, query, body }) ; l'API applique les scopes de ton identifiant à chaque appel. |
searchTools | Liste les outils d'agent que ton espace de travail et ton identifiant peuvent utiliser, avec leurs schémas d'entrée. Appelle-le en premier. |
runTool | Exécute un outil d'agent par son toolName exact, avec ses arguments comme objet params imbriqué. |
runCode | Enchaîne plusieurs outils d'agent en un seul appel depuis du TypeScript écrit sur un espace de noms tools.<name>(args). |
reportFeedback | Signale à l'équipe Polylane les frictions rencontrées avec le serveur, avec le client, l'identifiant de session et l'espace de travail attachés pour que l'équipe puisse les reproduire. |
Un outil n'apparaît dans searchTools que quand l'espace de travail a l'intégration correspondante connectée et que ton identifiant détient le scope correspondant.
Authentification
OAuth est la méthode par défaut : le serveur est un fournisseur OAuth 2.0 avec enregistrement dynamique des clients, donc un client qui se connecte sans en-têtes ouvre ton navigateur pour l'approuver et te connecter à Polylane. Une session OAuth peut couvrir plusieurs espaces de travail, donc passe workspaceId (identifiant ou slug) sur les appels d'outils d'agent.
Là où une connexion par navigateur n'est pas possible, comme en intégration continue ou sur une machine distante, ouvre Settings > Coding Agents et clique sur Create API key : la clé porte chaque scope de lecture que les outils MCP vérifient, n'est affichée qu'une fois et commence par sk_. Envoie-la comme x-api-key: <key> ou comme Authorization: Bearer <key> ; une clé est liée à un seul espace de travail, donc workspaceId est facultatif.
Installer dans ton éditeur
Claude Code, Cursor et Codex peuvent installer ce serveur avec les skills Polylane sous forme de plugin. Pour enregistrer le serveur seul, ajoute-le à ton client :
claude mcp add --transport http polylane https://mcp.polylane.com/mcp
{
"mcp": {
"polylane": {
"type": "remote",
"url": "https://mcp.polylane.com/mcp"
}
}
}
[mcp_servers.polylane]
url = "https://mcp.polylane.com/mcp"
Si ta version n'a pas le streamable HTTP, fais le pont avec npx mcp-remote https://mcp.polylane.com/mcp.
{
"mcpServers": {
"polylane": {
"type": "http",
"url": "https://mcp.polylane.com/mcp"
}
}
}
{
"servers": {
"polylane": {
"type": "http",
"url": "https://mcp.polylane.com/mcp"
}
}
}
Chaque client ouvre un navigateur pour se connecter à la première utilisation. Pour utiliser une clé API à la place, ajoute un en-tête x-api-key à la même entrée via le réglage d'en-têtes de ton client, comme --header "x-api-key: YOUR_API_KEY" pour Claude Code ou http_headers pour Codex.
Écritures
Les outils d'agent restent en lecture seule jusqu'à ce que la session envoie x-polylane-allow-writes: true avec un identifiant qui porte le scope agent_tools:write. Un modèle de sécurité filtre chaque écriture et les clients qui prennent en charge l'élicitation te demandent d'approuver chacune ; voir Lectures par défaut, écritures derrière un garde-fou.
Limites
Chaque identifiant peut faire 600 requêtes par 60 secondes. Les requêtes au-delà de ce budget reçoivent une réponse de limitation de débit jusqu'à la réinitialisation de la fenêtre.
Voir aussi
- Travaille depuis tes outils : comment le serveur MCP, la CLI et les plugins s'articulent.
- Plugins : installe ce serveur, le serveur des docs et les skills en une étape.
- Serveur MCP des docs : le serveur séparé qui laisse ton agent chercher et lire ces docs.
- Clés API et OAuth : scopes, gestion des clés et clients OAuth.
- Intégration MCP : laisse les agents de Polylane appeler des outils d'un serveur que tu fais tourner.