Server MCP della piattaforma
Polylane esegue un server Model Context Protocol su https://mcp.polylane.com/mcp con trasporto streamable HTTP. Collega qualsiasi client MCP e il tuo agente può interrogare telemetria, topologia, codice e issue senza lasciare l'editor.
Cosa fa
Il server espone l'API REST di Polylane, gli stessi strumenti degli agenti che gli agenti di Polylane usano su ogni provider collegato del catalogo. La server card su https://mcp.polylane.com/.well-known/mcp elenca ogni strumento. Una volta collegato, chiedi al tuo agente qualcosa come "Usa Polylane per mostrarmi il tasso di errore del servizio che questo branch deploya, nell'ultima ora."
Strumenti
| Strumento | Descrizione |
|---|---|
search | Interroga la specifica OpenAPI di Polylane da una piccola funzione asincrona che gira in una sandbox su una copia risolta della specifica. In sola lettura. |
execute | Chiama l'API REST tramite codemode.request({ method, path, query, body }); l'API applica gli scope della tua credenziale a ogni chiamata. |
searchTools | Elenca gli strumenti degli agenti che il tuo workspace e la tua credenziale possono usare, con i loro schemi di input. Chiamalo per primo. |
runTool | Esegue un singolo strumento degli agenti tramite il suo toolName esatto, con gli argomenti come oggetto params annidato. |
runCode | Concatena diversi strumenti degli agenti in una sola chiamata con TypeScript scritto su un namespace tools.<name>(args). |
reportFeedback | Segnala al team Polylane gli attriti con il server, con client, id di sessione e workspace allegati così il team può riprodurli. |
Uno strumento compare in searchTools solo quando il workspace ha l'integrazione corrispondente collegata e la tua credenziale possiede lo scope adatto.
Autenticazione
OAuth è il metodo predefinito: il server è un provider OAuth 2.0 con registrazione dinamica dei client, quindi un client che si collega senza header apre il tuo browser per approvarlo e accedere a Polylane. Una sessione OAuth può coprire più workspace, quindi passa workspaceId (id o slug) nelle chiamate agli strumenti degli agenti.
Dove l'accesso dal browser non è possibile, come nella continuous integration o su una macchina remota, apri Settings > Coding Agents e fai clic su Create API key: la chiave porta ogni scope di lettura che gli strumenti MCP verificano, viene mostrata una sola volta e inizia con sk_. Inviala come x-api-key: <key> oppure come Authorization: Bearer <key>; una chiave è legata a un solo workspace, quindi workspaceId è facoltativo.
Installa nel tuo editor
Claude Code, Cursor e Codex possono installare questo server insieme alle skill di Polylane come plugin. Per registrare il server da solo, aggiungilo al tuo 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"
Se la tua build non supporta streamable HTTP, fai da ponte con 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"
}
}
}
Ogni client apre un browser per accedere al primo utilizzo. Per usare invece una chiave API, aggiungi un header x-api-key alla stessa voce tramite l'impostazione degli header del tuo client, come --header "x-api-key: YOUR_API_KEY" per Claude Code o http_headers per Codex.
Scritture
Gli strumenti degli agenti restano in sola lettura finché la sessione non invia x-polylane-allow-writes: true con una credenziale che porta lo scope agent_tools:write. Un modello di sicurezza vaglia ogni scrittura e i client che supportano l'elicitation ti chiedono di approvarne ciascuna; vedi Letture per impostazione predefinita, scritture dietro un gate.
Limiti
Ogni credenziale può fare 600 richieste ogni 60 secondi. Le richieste oltre quel budget ricevono una risposta di rate limit finché la finestra non si azzera.
Correlati
- Lavora dai tuoi strumenti: come il server MCP, la CLI e i plugin stanno insieme.
- Plugin: installa questo server, il server della documentazione e le skill in un solo passo.
- Server MCP della documentazione: il server separato che lascia al tuo agente cercare e leggere questa documentazione.
- Chiavi API e OAuth: scope, gestione delle chiavi e client OAuth.
- Integrazione MCP: lascia che gli agenti di Polylane chiamino strumenti da un server che gestisci tu.