MCP-серверы

Model Context Protocol (MCP) — открытый стандарт для подключения агентов к инструментам и данным: трекерам задач, базам данных, браузерам, инструментам дизайна, внутренним API. Cusp — MCP-клиент. Любой сервер, который работает с другим MCP-клиентом, работает и с Cusp.

Файлы конфигурацииСкопировать ссылку на раздел

У всех файлов один формат:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer ${GITHUB_TOKEN}" }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}

Если в двух областях задан сервер с одинаковым именем, побеждает вся запись из области с более высоким приоритетом; поля не объединяются. От высшего приоритета к низшему: управляемая, командная строка, локальная, проект, пользователь, настройки, затем серверы, объявленные субагентами. В пределах одной области файлы из .cusp/ побеждают .mcp.json и ~/.claude.json.

ТранспортыСкопировать ссылку на раздел

stdioСкопировать ссылку на раздел

Cusp запускает сервер как дочерний процесс и общается с ним через stdin и stdout.

HTTPСкопировать ссылку на раздел

Cusp подключается к удалённому серверу по транспорту streamable HTTP, а для серверов, которые поддерживают только более старый транспорт SSE, переключается на него.

Общие поляСкопировать ссылку на раздел

ПеременныеСкопировать ссылку на раздел

${VAR} в любой строке заменяется переменной окружения VAR при запуске сервера. ${CUSP_PROJECT_DIR} и ${CLAUDE_PROJECT_DIR} указывают на корень проекта. Храните секреты в окружении, а не в закоммиченных файлах.

Подставленные значения, включая секреты, никогда не показываются модели.

Подтверждение серверов проектаСкопировать ссылку на раздел

Файл .mcp.json проекта написал тот, кто создал репозиторий. Прежде чем Cusp подключится к серверу, описанному в нём, вы его подтверждаете. Подтверждение привязано к хешу конкретной записи, поэтому если кто-то позже изменит команду или URL, Cusp спросит снова.

Подтвердить серверы заранее можно в настройках:

В недоверенной рабочей области собственные настройки проекта не могут подтверждать его серверы.

Инструменты и ресурсыСкопировать ссылку на раздел

Каждый инструмент сервера становится инструментом Cusp с именем mcp__<server>__<tool>. Схема входных данных — собственная JSON Schema сервера.

По умолчанию инструменты MCP откладываются: модель видит их имена и загружает определения через ToolSearch, когда инструмент нужен. Так сервер с пятьюдесятью инструментами не заполняет контекст на каждом ходе. Задайте alwaysLoad: true для сервера, инструменты которого нужны агенту постоянно.

Доступ к ресурсам серверов дают два встроенных инструмента: ListMcpResourcesTool и ReadMcpResourceTool.

РазрешенияСкопировать ссылку на раздел

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

{
  "permissions": {
    "allow": ["mcp__github__get_issue", "mcp__github__list_pull_requests"],
    "ask": ["mcp__github__*"],
    "deny": ["mcp__postgres__execute"]
  }
}

Серверы для отдельных агентовСкопировать ссылку на раздел

Субагент может перечислить серверы в своём frontmatter — по имени или встроенным определением. Встроенные серверы доступны только этому агенту. См. Агенты.

Устранение неполадокСкопировать ссылку на раздел

• Сервер не появляется. Проверьте, что он подтверждён (для серверов проекта) и что команда сама по себе запускается в терминале.
• Не хватает инструментов. Они отложены. Попросите агента использовать инструмент по имени или задайте alwaysLoad.
• Переменные приходят пустыми. ${VAR} берётся из окружения демона (daemon). Приложение, запущенное из Dock или меню «Пуск», может не видеть переменные, экспортированные в профиле вашей оболочки. Проверьте через CLI, запущенный из терминала: он их видит.