Работа с документацией через MCP#

MCP-сервер позволяет подключить опубликованную документацию К2 Облака к ИИ-клиенту с поддержкой Model Context Protocol. Клиент сможет искать информацию в документации, читать найденные страницы и добавлять ссылки на источники в ответ.

Подключение#

Для подключения используйте следующие параметры:

  • адрес сервера: https://mcp-docs.k2.cloud/mcp;

  • транспорт: Streamable HTTP.

  1. Откройте настройки MCP-серверов в ИИ-клиенте.

  2. Добавьте сервер с транспортом Streamable HTTP.

  3. Укажите адрес https://mcp-docs.k2.cloud/mcp.

  4. Сохраните настройки и включите MCP-сервер, если он ещё не был включён.

Названия параметров зависят от используемого клиента. Если клиент поддерживает конфигурацию mcpServers, запись может выглядеть так:

{
  "mcpServers": {
    "k2-docs": {
      "url": "https://mcp-docs.k2.cloud/mcp"
    }
  }
}

Использование#

MCP-сервер предоставляет документацию на русском и английском языках. После подключения задавайте вопросы на естественном языке. При необходимости можно указать язык документации и дополнительные условия задачи, например:

  • «Объясни, как создать экземпляр. Приведи ссылки на источники.»

  • «Найди рекомендации по созданию отказоустойчивого PostgreSQL.»

  • «Найди инструкцию по созданию VPN-соединения и перечисли основные шаги.»

Проверка подключения#

Чтобы проверить сервер без ИИ-клиента, выполните запрос:

curl -fsS https://mcp-docs.k2.cloud/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

В ответе должен присутствовать список tools. Если клиент не подключается, проверьте, что адрес оканчивается на /mcp, а в качестве транспорта выбран Streamable HTTP.