Русский
Документация
MCP серверы

MCP-серверы

OpenCode поддерживает Model Context Protocol (MCP) для добавления внешних инструментов через локальные и удалённые серверы.

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

Включение MCP-серверов

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "server-name": {
      "enabled": true
    }
  }
}

Локальные MCP-серверы

{
  "mcp": {
    "my-local-server": {
      "type": "local",
      "command": ["npx", "-y", "my-mcp-command"],
      "enabled": true,
      "environment": {
        "MY_ENV_VAR": "value"
      }
    }
  }
}

Параметры локального сервера

ПараметрТипОбязательный
typeStringДа ("local")
commandArrayДа
environmentObjectНет
timeoutNumberНет (по умолчанию: 5000)

Удалённые MCP-серверы

{
  "mcp": {
    "my-remote-server": {
      "type": "remote",
      "url": "https://my-mcp-server.com",
      "headers": {
        "Authorization": "Bearer API_KEY"
      }
    }
  }
}

OAuth-аутентификация

opencode mcp auth server-name
opencode mcp list
opencode mcp logout server-name

Управление MCP-инструментами

Глобально

{
  "tools": {
    "my-mcp*": false
  }
}

Для агента

{
  "agent": {
    "my-agent": {
      "tools": {
        "my-mcp*": true
      }
    }
  }
}

Примеры

Sentry

{
  "mcp": {
    "sentry": {
      "type": "remote",
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

GitHub Code Search

{
  "mcp": {
    "gh_grep": {
      "type": "remote",
      "url": "https://mcp.grep.app"
    }
  }
}