플랫폼 MCP 서버
Polylane은 https://mcp.polylane.com/mcp에서 스트리밍 가능한 HTTP로 Model Context Protocol 서버를 실행합니다. 어떤 MCP 클라이언트든 연결하면 에이전트가 에디터를 떠나지 않고 텔레메트리, 토폴로지, 코드, 이슈를 질의할 수 있습니다.
하는 일
서버는 Polylane REST API와 Polylane 자체 에이전트가 카탈로그의 연결된 모든 제공자에 걸쳐 사용하는 에이전트 도구를 제공합니다. https://mcp.polylane.com/.well-known/mcp의 서버 카드에 모든 도구가 나열되어 있습니다. 연결한 뒤 에이전트에게 이렇게 물어보세요: "Polylane을 사용해 이 브랜치가 배포하는 서비스의 지난 한 시간 동안 오류율을 보여 주세요."
도구
| 도구 | 설명 |
|---|---|
search | 해석된 명세 복사본에 대해 샌드박스에서 실행되는 작은 비동기 함수로 Polylane OpenAPI 명세를 질의합니다. 읽기 전용입니다. |
execute | codemode.request({ method, path, query, body })로 REST API를 호출합니다. API는 모든 호출에서 자격 증명의 스코프를 강제합니다. |
searchTools | 워크스페이스와 자격 증명이 사용할 수 있는 에이전트 도구를 입력 스키마와 함께 나열합니다. 이것을 먼저 호출하세요. |
runTool | 정확한 toolName으로 에이전트 도구 하나를 실행하며, 인수는 중첩된 params 객체로 전달합니다. |
runCode | tools.<name>(args) 네임스페이스에 대해 작성한 TypeScript로 여러 에이전트 도구를 한 번의 호출로 연결합니다. |
reportFeedback | 서버 사용 중 겪은 불편을 클라이언트, 세션 id, 워크스페이스와 함께 Polylane 팀에 보고하여 팀이 재현할 수 있게 합니다. |
도구는 워크스페이스에 뒷받침하는 통합이 연결되어 있고 자격 증명이 해당 스코프를 갖고 있을 때만 searchTools에 나타납니다.
인증
OAuth가 기본입니다: 서버는 동적 클라이언트 등록을 지원하는 OAuth 2.0 제공자이므로, 헤더 없이 연결하는 클라이언트는 브라우저를 열어 승인하고 Polylane에 로그인하게 합니다. OAuth 세션은 여러 워크스페이스에 걸칠 수 있으므로, 에이전트 도구 호출에 workspaceId(id 또는 슬러그)를 전달하세요.
지속적 통합이나 원격 머신처럼 브라우저 로그인이 불가능한 곳에서는 Settings > Coding Agents를 열고 Create API key를 클릭하세요: 키는 MCP 도구가 검사하는 모든 읽기 스코프를 갖고, 한 번만 표시되며, sk_로 시작합니다. x-api-key: <key> 또는 Authorization: Bearer <key>로 보내세요. 키는 하나의 워크스페이스에 묶이므로 workspaceId는 선택 사항입니다.
에디터에 설치
Claude Code, Cursor, Codex는 이 서버를 Polylane 스킬과 함께 플러그인으로 설치할 수 있습니다. 서버만 따로 등록하려면 클라이언트에 추가하세요:
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"
빌드에 스트리밍 가능한 HTTP가 없다면 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"
}
}
}
각 클라이언트는 처음 사용할 때 브라우저를 열어 로그인합니다. 대신 API 키를 사용하려면 클라이언트의 헤더 설정을 통해 같은 항목에 x-api-key 헤더를 추가하세요. Claude Code에서는 --header "x-api-key: YOUR_API_KEY", Codex에서는 http_headers입니다.
쓰기
에이전트 도구는 세션이 agent_tools:write 스코프를 가진 자격 증명과 함께 x-polylane-allow-writes: true를 보내기 전까지 읽기 전용으로 유지됩니다. 안전성 모델이 모든 쓰기를 심사하고, elicitation을 지원하는 클라이언트는 각 쓰기의 승인을 요청합니다. 기본은 읽기, 쓰기는 게이트 뒤에를 참고하세요.
제한
각 자격 증명은 60초당 600개의 요청을 보낼 수 있습니다. 이 예산을 넘는 요청은 창이 초기화될 때까지 속도 제한 응답을 받습니다.
관련 문서
- 내 도구에서 작업: MCP 서버, CLI, 플러그인이 어떻게 맞물리는지.
- Plugins: 이 서버, 문서 서버, 스킬을 한 번에 설치.
- 문서 MCP 서버: 에이전트가 이 문서를 검색하고 읽게 하는 별도의 서버.
- API 키와 OAuth: 스코프, 키 관리, OAuth 클라이언트.
- MCP 통합: Polylane의 에이전트가 사용자가 운영하는 서버의 도구를 호출하게 하세요.