MCP-сервер платформы
Polylane запускает сервер Model Context Protocol по адресу https://mcp.polylane.com/mcp через потоковый HTTP. Подключите любой MCP-клиент, и ваш агент сможет запрашивать телеметрию, топологию, код и проблемы, не покидая редактор.
Что это даёт
Сервер предоставляет REST API Polylane, те же инструменты агентов, которыми пользуются собственные агенты Polylane для каждого подключённого провайдера из каталога. Карточка сервера по адресу https://mcp.polylane.com/.well-known/mcp перечисляет каждый инструмент. После подключения попросите агента о чём-то вроде: «Используй Polylane, чтобы показать мне частоту ошибок сервиса, который деплоит эта ветка, за последний час».
Инструменты
| Инструмент | Описание |
|---|---|
search | Запрашивает спецификацию OpenAPI Polylane из небольшой асинхронной функции, которая выполняется в песочнице над разрешённой копией спецификации. Только чтение. |
execute | Вызывает REST API через codemode.request({ method, path, query, body }); API применяет области ваших учётных данных к каждому вызову. |
searchTools | Перечисляет инструменты агентов, доступные вашему рабочему пространству и учётным данным, с их схемами входа. Вызывайте его первым. |
runTool | Запускает один инструмент агента по его точному toolName, с аргументами во вложенном объекте params. |
runCode | Связывает несколько инструментов агентов в одном вызове из TypeScript, написанного против пространства имён tools.<name>(args). |
reportFeedback | Сообщает команде Polylane о трениях с сервером, прикладывая клиент, идентификатор сессии и рабочее пространство, чтобы команда могла их воспроизвести. |
Инструмент появляется в searchTools, только когда в рабочем пространстве подключена соответствующая интеграция, а ваши учётные данные несут подходящую область.
Аутентификация
OAuth используется по умолчанию: сервер является провайдером OAuth 2.0 с динамической регистрацией клиентов, так что клиент, подключившийся без заголовков, открывает браузер, чтобы вы одобрили его и вошли в Polylane. Сессия OAuth может охватывать несколько рабочих пространств, поэтому передавайте workspaceId (идентификатор или slug) в вызовах инструментов агентов.
Там, где вход через браузер невозможен, например в непрерывной интеграции или на удалённой машине, откройте 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 к той же записи через настройку заголовков вашего клиента, например --header "x-api-key: YOUR_API_KEY" для Claude Code или http_headers для Codex.
Запись
Инструменты агентов остаются только для чтения, пока сессия не отправит x-polylane-allow-writes: true с учётными данными, несущими область agent_tools:write. Модель безопасности проверяет каждую запись, а клиенты, поддерживающие elicitation, просят вас одобрить каждую; см. Чтение по умолчанию, запись за шлюзом.
Лимиты
Каждые учётные данные могут делать 600 запросов за 60 секунд. Запросы сверх этого бюджета получают ответ об ограничении частоты, пока окно не сбросится.
См. также
- Работа в ваших инструментах: как MCP-сервер, CLI и плагины сочетаются друг с другом.
- Plugins: установите этот сервер, сервер документации и навыки за один шаг.
- MCP-сервер документации: отдельный сервер, который даёт агенту искать и читать эту документацию.
- API-ключи и OAuth: области, управление ключами и OAuth-клиенты.
- Интеграция MCP: дайте агентам Polylane вызывать инструменты с сервера, который вы запускаете.