Skip to content

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

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

Endpoint ​

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

Базовый URL: https://mcp.speka.click/mcp.

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

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

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

Инструменты ​

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

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

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

Примеры ​

initialize ​

bash
curl -X POST https://mcp.speka.click/mcp \
  -H "Authorization: Bearer $SPEKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

tools/list ​

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

tools/call ​

bash
curl -X POST https://mcp.speka.click/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":{}}}'

Speka Docs — VitePress + distroless