Servidor MCP de la plataforma
Polylane ejecuta un servidor Model Context Protocol en https://mcp.polylane.com/mcp sobre HTTP en streaming. Conecta cualquier cliente MCP y tu agente puede consultar la telemetría, la topología, el código y los issues sin salir de tu editor.
Qué hace
El servidor expone la API REST de Polylane, las mismas herramientas de agente que usan los propios agentes de Polylane en todos los proveedores conectados del catálogo. La tarjeta del servidor en https://mcp.polylane.com/.well-known/mcp lista cada herramienta. Una vez conectado, pide a tu agente algo como "Usa Polylane para mostrarme la tasa de errores del servicio que despliega esta rama, durante la última hora."
Herramientas
| Herramienta | Descripción |
|---|---|
search | Consulta la especificación OpenAPI de Polylane desde una pequeña función asíncrona que se ejecuta en un sandbox contra una copia resuelta de la especificación. Solo lectura. |
execute | Llama a la API REST a través de codemode.request({ method, path, query, body }); la API aplica los ámbitos de tu credencial en cada llamada. |
searchTools | Lista las herramientas de agente que tu espacio de trabajo y tu credencial pueden usar, con sus esquemas de entrada. Llámala primero. |
runTool | Ejecuta una herramienta de agente por su toolName exacto, con sus argumentos como un objeto params anidado. |
runCode | Encadena varias herramientas de agente en una sola llamada desde TypeScript escrito contra un espacio de nombres tools.<name>(args). |
reportFeedback | Informa de fricciones con el servidor al equipo de Polylane, con el cliente, el id de sesión y el espacio de trabajo adjuntos para que el equipo pueda reproducirlas. |
Una herramienta aparece en searchTools solo cuando el espacio de trabajo tiene conectada la integración que la respalda y tu credencial lleva el ámbito correspondiente.
Autenticación
OAuth es el método por defecto: el servidor es un proveedor OAuth 2.0 con registro dinámico de clientes, así que un cliente que se conecta sin cabeceras abre tu navegador para aprobarlo e iniciar sesión en Polylane. Una sesión OAuth puede abarcar varios espacios de trabajo, así que pasa workspaceId (id o slug) en las llamadas a herramientas de agente.
Donde no es posible iniciar sesión desde un navegador, como en integración continua o en una máquina remota, abre Settings > Coding Agents y haz clic en Create API key: la clave lleva todos los ámbitos de lectura que comprueban las herramientas MCP, se muestra una sola vez y empieza por sk_. Envíala como x-api-key: <key> o como Authorization: Bearer <key>; una clave está ligada a un espacio de trabajo, así que workspaceId es opcional.
Instalar en tu editor
Claude Code, Cursor y Codex pueden instalar este servidor junto con los skills de Polylane como un plugin. Para registrar el servidor por separado, añádelo a tu cliente:
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 tu versión no admite HTTP en streaming, haz de puente 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"
}
}
}
Cada cliente abre un navegador para iniciar sesión en el primer uso. Para usar una clave de API en su lugar, añade una cabecera x-api-key a la misma entrada mediante el ajuste de cabeceras de tu cliente, como --header "x-api-key: YOUR_API_KEY" en Claude Code o http_headers en Codex.
Escrituras
Las herramientas de agente permanecen en solo lectura hasta que la sesión envía x-polylane-allow-writes: true con una credencial que lleve el ámbito agent_tools:write. Un modelo de seguridad examina cada escritura y los clientes que admiten elicitación te piden que apruebes cada una; consulta Lecturas por defecto, escrituras tras un control.
Límites
Cada credencial puede hacer 600 peticiones por 60 segundos. Las peticiones que superan ese presupuesto reciben una respuesta de límite de tasa hasta que la ventana se reinicia.
Relacionado
- Trabaja desde tus herramientas: cómo encajan el servidor MCP, la CLI y los plugins.
- Plugins: instala este servidor, el servidor de documentación y los skills en un solo paso.
- Servidor MCP de la documentación: el servidor aparte que deja a tu agente buscar y leer esta documentación.
- Claves de API y OAuth: ámbitos, gestión de claves y clientes OAuth.
- Integración MCP: deja que los agentes de Polylane llamen a herramientas de un servidor que tú ejecutas.