Подключение Speka через MCP

Speka предоставляет MCP-эндпоинт для подключения AI-ассистентов и внешних инструментов к вашему рабочему пространству.

Endpoint

• POST /mcp — JSON-RPC запросы (initialize, tools/list, tools/call)
• GET /mcp — health-check

Базовый URL: https://<docs-domain>/mcp — замените <docs-domain> на домен вашего инстанса Speka.

Аутентификация

• Заголовок: Authorization: Bearer <API-ключ>
• Создайте API-ключ в профиле Speka (Профиль → API-ключи).

Все MCP-запросы требуют валидный API-ключ. Храните ключ в секрете и передавайте только через заголовок Authorization.

Инструменты

Доступные инструменты через tools/list:

• speka_list_projects — список проектов, доступных владельцу ключа
• speka_list_docs — список документов в проекте
• speka_search_docs — поиск по документам

Подробные схемы входных/выходных данных возвращает метод tools/list.

Примеры

initialize

curl -X POST https://<docs-domain>/mcp \
  -H "Authorization: Bearer $SPEKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

tools/list

curl -X POST https://<docs-domain>/mcp \
  -H "Authorization: Bearer $SPEKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

tools/call

curl -X POST https://<docs-domain>/mcp \
  -H "Authorization: Bearer $SPEKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"speka_list_projects","arguments":{}}}'

Публичный доступ

Документация открывается без авторизации; приватные пути платформы (/api, /socket.io/) остаются защищёнными.