Polylane para desenvolvedores
Tudo o que você precisa para construir sobre o Polylane: a API, o servidor MCP, a CLI, o SDK e como se autenticar. Agentes: esta página também está disponível em markdown em /developers.md.
Início rápido do Polylane
- Obtenha acesso: o Polylane está em pré-lançamento; entre na lista de espera na página inicial (ou
POST https://polylane.com/api/auth/email). - Faça login: depois de convidado, entre em console.polylane.com e conecte uma conta de nuvem ou um repositório.
- Gere uma chave de API: crie uma chave (
sk_...) nas configurações do console. - Primeira requisição:
curl https://api.polylane.com/v1/auth/whoami -H "x-api-key: sk_..." - Conecte um agente: aponte qualquer cliente MCP para
https://mcp.polylane.com/mcp. Clientes OAuth se registram sozinhos emhttps://mcp.polylane.com/register.
API do Polylane
- URL base:
https://api.polylane.com/v1 - Especificação OpenAPI 3.0: https://api.polylane.com/v1/doc (espelhada em /openapi.json)
- API catalog (RFC 9727): /.well-known/api-catalog
- Guia de autenticação para agentes: /auth.md
Servidores MCP do Polylane
- Produto (OAuth 2.0 ou chave de API):
https://mcp.polylane.com/mcp, com as ferramentassearch,execute,searchTools,runTool,runCode,startMapping,advanceMapping,getMappingStatus. Server card. - Documentação (sem autenticação):
https://docs.polylane.com/mcp, para listar e ler todas as páginas da documentação.
CLI do Polylane
Feita para ser conduzida por agentes de programação: saída estruturada e flags não interativas em todo lugar.
curl -fsSL https://polylane.com/setup.sh | bash # macOS / Linux
irm https://polylane.com/setup.ps1 | iex # Windows
polylane auth signup --email you@example.com Documentação completa da CLI: docs.polylane.com/coding-agents/cli.
SDK
- npm: @coreplane/polylane
Limites de requisições
As requisições têm limite de taxa por credencial. Quando você ultrapassa um limite, a API retorna
429: recue e respeite Retry-After
quando presente, com backoff exponencial em vez de repetir em loop.
Versionamento e descontinuação
A API é versionada no caminho da URL (/v1). Mudanças incompatíveis só saem em uma nova versão. Descontinuações são anunciadas no build log
e documentadas antes da remoção; superfícies descontinuadas continuam funcionando durante a janela de transição.
Pontos de entrada legíveis por máquina
- /llms.txt: índice do site para agentes
- /agent.json: visão estruturada do produto (também em
/?mode=agent) - /.well-known/mcp: descoberta de MCP
- /.well-known/agent-card.json: agent card A2A
- /.well-known/agent-skills/index.json: índice de skills
Status
Disponibilidade ao vivo da plataforma Polylane: status.polylane.com.
Suporte
Escreva para boris@coreplane.ai ou fale com a gente no X em @polylanehq.