Trabalhe a partir das suas ferramentas

Servidor MCP da plataforma

Conecte qualquer cliente MCP ao Polylane e consulte telemetria, a topologia, o código e as issues a partir do seu editor, com escritas apenas quando você optar por elas.

O Polylane executa um servidor Model Context Protocol em https://mcp.polylane.com/mcp sobre streamable HTTP. Conecte qualquer cliente MCP e seu agente pode consultar telemetria, a topologia, o código e as issues sem sair do editor.

O que faz

O servidor expõe a API REST do Polylane, as mesmas ferramentas de agente que os próprios agentes do Polylane usam em todo provedor conectado do catálogo. O cartão do servidor em https://mcp.polylane.com/.well-known/mcp lista toda ferramenta. Uma vez conectado, peça ao seu agente algo como "Use o Polylane para me mostrar a taxa de erro do serviço que esta branch implanta, na última hora."

Ferramentas

Ferramenta	Descrição
`search`	Consulta a especificação OpenAPI do Polylane a partir de uma pequena função assíncrona que roda em um sandbox contra uma cópia resolvida da especificação. Somente leitura.
`execute`	Chama a API REST por `codemode.request({ method, path, query, body })`; a API aplica os escopos da sua credencial em toda chamada.
`searchTools`	Lista as ferramentas de agente que o seu workspace e a sua credencial podem usar, com seus schemas de entrada. Chame-a primeiro.
`runTool`	Executa uma ferramenta de agente pelo seu `toolName` exato, com os argumentos como um objeto `params` aninhado.
`runCode`	Encadeia várias ferramentas de agente em uma chamada a partir de TypeScript escrito contra um namespace `tools.<name>(args)`.
`reportFeedback`	Relata atritos com o servidor ao time do Polylane, com o cliente, o id da sessão e o workspace anexados para que o time possa reproduzi-los.

Uma ferramenta só aparece em searchTools quando o workspace tem a integração correspondente conectada e a sua credencial carrega o escopo correspondente.

Autenticação

OAuth é o padrão: o servidor é um provedor OAuth 2.0 com registro dinâmico de cliente, então um cliente que se conecta sem cabeçalhos abre o seu navegador para aprová-lo e fazer login no Polylane. Uma sessão OAuth pode abranger vários workspaces, então passe workspaceId (id ou slug) nas chamadas de ferramentas de agente.

Onde um login pelo navegador não é possível, como em integração contínua ou em uma máquina remota, abra Settings > Coding Agents e clique em Create API key: a chave carrega todo escopo de leitura que as ferramentas MCP verificam, é mostrada uma vez e começa com sk_. Envie-a como x-api-key: <key> ou como Authorization: Bearer <key>; uma chave é vinculada a um workspace, então workspaceId é opcional.

Instalar no seu editor

Claude Code, Cursor e Codex podem instalar este servidor junto com as skills do Polylane como um plugin. Para registrar o servidor sozinho, adicione-o ao seu cliente:

Terminal

claude mcp add --transport http polylane https://mcp.polylane.com/mcp

opencode.json

{
  "mcp": {
    "polylane": {
      "type": "remote",
      "url": "https://mcp.polylane.com/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.polylane]
url = "https://mcp.polylane.com/mcp"

Se a sua build não tiver streamable HTTP, faça a ponte com npx mcp-remote https://mcp.polylane.com/mcp.

.cursor/mcp.json

{
  "mcpServers": {
    "polylane": {
      "type": "http",
      "url": "https://mcp.polylane.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "polylane": {
      "type": "http",
      "url": "https://mcp.polylane.com/mcp"
    }
  }
}

Cada cliente abre um navegador para fazer login no primeiro uso. Para usar uma chave de API em vez disso, adicione um cabeçalho x-api-key à mesma entrada pela configuração de cabeçalhos do seu cliente, como --header "x-api-key: YOUR_API_KEY" no Claude Code ou http_headers no Codex.

Escritas

As ferramentas de agente permanecem somente leitura até que a sessão envie x-polylane-allow-writes: true com uma credencial que carregue o escopo agent_tools:write. Um modelo de segurança filtra toda escrita e clientes que suportam elicitação pedem que você aprove cada uma; veja Leituras por padrão, escritas atrás de uma barreira.

Limites

Cada credencial pode fazer 600 requisições a cada 60 segundos. Requisições além desse orçamento recebem uma resposta de limite de taxa até a janela ser redefinida.

Relacionado

Trabalhe a partir das suas ferramentas: como o servidor MCP, a CLI e os plugins se encaixam.
Plugins: instale este servidor, o servidor da documentação e as skills em uma etapa.
Servidor MCP da documentação: o servidor separado que deixa seu agente pesquisar e ler esta documentação.
Chaves de API e OAuth: escopos, gerenciamento de chaves e clientes OAuth.
Integração MCP: deixe os agentes do Polylane chamarem ferramentas de um servidor que você executa.

Trabalhe a partir das suas ferramentas

Pergunte sobre a produção a partir do seu agente de programação, terminal ou CI: um servidor MCP, uma CLI e um plugin que instala os dois.

CLI

Instale o comando polylane, faça login e conduza cada parte do Polylane a partir de um terminal, de um script ou de um agente de programação.