Serwer MCP platformy
Polylane uruchamia serwer Model Context Protocol pod adresem https://mcp.polylane.com/mcp przez streamable HTTP. Połącz dowolnego klienta MCP, a twój agent będzie mógł odpytywać telemetrię, topologię, kod i problemy bez opuszczania edytora.
Co robi
Serwer udostępnia REST API Polylane, te same narzędzia agentów, których używają własni agenci Polylane u każdego połączonego dostawcy z katalogu. Karta serwera pod https://mcp.polylane.com/.well-known/mcp wymienia każde narzędzie. Po połączeniu poproś agenta na przykład: „Użyj Polylane, aby pokazać mi wskaźnik błędów usługi, którą wdraża ta gałąź, z ostatniej godziny.”
Narzędzia
| Narzędzie | Opis |
|---|---|
search | Odpytuje specyfikację OpenAPI Polylane z małej asynchronicznej funkcji uruchamianej w sandboxie na rozwiązanej kopii specyfikacji. Tylko do odczytu. |
execute | Wywołuje REST API przez codemode.request({ method, path, query, body }); API wymusza zakresy twojego poświadczenia przy każdym wywołaniu. |
searchTools | Wymienia narzędzia agentów, których może używać twój obszar roboczy i poświadczenie, wraz ze schematami wejścia. Wywołaj je jako pierwsze. |
runTool | Uruchamia jedno narzędzie agenta po jego dokładnej nazwie toolName, z argumentami jako zagnieżdżonym obiektem params. |
runCode | Łączy kilka narzędzi agentów w jednym wywołaniu z TypeScriptu napisanego na przestrzeni nazw tools.<name>(args). |
reportFeedback | Zgłasza zespołowi Polylane trudności z serwerem, z dołączonym klientem, identyfikatorem sesji i obszarem roboczym, żeby zespół mógł je odtworzyć. |
Narzędzie pojawia się w searchTools tylko wtedy, gdy obszar roboczy ma połączoną integrację, która za nim stoi, a twoje poświadczenie ma pasujący zakres.
Uwierzytelnianie
OAuth jest domyślny: serwer jest dostawcą OAuth 2.0 z dynamiczną rejestracją klientów, więc klient, który łączy się bez nagłówków, otwiera przeglądarkę do zatwierdzenia klienta i zalogowania się w Polylane. Sesja OAuth może obejmować kilka obszarów roboczych, więc przekazuj workspaceId (identyfikator albo slug) w wywołaniach narzędzi agentów.
Tam, gdzie logowanie w przeglądarce nie jest możliwe, na przykład w ciągłej integracji albo na zdalnej maszynie, otwórz Settings > Coding Agents i kliknij Create API key: klucz ma każdy zakres odczytu sprawdzany przez narzędzia MCP, jest pokazywany raz i zaczyna się od sk_. Wysyłaj go jako x-api-key: <key> albo jako Authorization: Bearer <key>; klucz jest związany z jednym obszarem roboczym, więc workspaceId jest opcjonalny.
Instalacja w edytorze
Claude Code, Cursor i Codex mogą zainstalować ten serwer razem ze skillami Polylane jako wtyczkę. Żeby zarejestrować sam serwer, dodaj go do swojego klienta:
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"
Jeśli twoja wersja nie obsługuje streamable HTTP, użyj mostka 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"
}
}
}
Każdy klient przy pierwszym użyciu otwiera przeglądarkę do logowania. Żeby użyć zamiast tego klucza API, dodaj nagłówek x-api-key do tego samego wpisu przez ustawienie nagłówków swojego klienta, na przykład --header "x-api-key: YOUR_API_KEY" dla Claude Code albo http_headers dla Codex.
Zapisy
Narzędzia agentów pozostają tylko do odczytu, dopóki sesja nie wyśle x-polylane-allow-writes: true z poświadczeniem mającym zakres agent_tools:write. Model bezpieczeństwa sprawdza każdy zapis, a klienci obsługujący elicytację pytają cię o zgodę na każdy z nich; zobacz Domyślnie odczyt, zapis za bramką.
Limity
Każde poświadczenie może wykonać 600 żądań na 60 sekund. Żądania ponad ten budżet otrzymują odpowiedź o limicie szybkości, dopóki okno się nie zresetuje.
Powiązane
- Pracuj z własnych narzędzi: jak serwer MCP, CLI i wtyczki do siebie pasują.
- Plugins: zainstaluj ten serwer, serwer dokumentacji i skille w jednym kroku.
- Serwer MCP dokumentacji: osobny serwer, który pozwala agentowi przeszukiwać i czytać tę dokumentację.
- Klucze API i OAuth: zakresy, zarządzanie kluczami i klienci OAuth.
- Integracja MCP: pozwól agentom Polylane wywoływać narzędzia z serwera, który sam prowadzisz.