Перейти к основному содержимому

Настройка клиента

Ниже — конфигурация для популярных программ. Везде используется один и тот же адрес:

https://api.metriox.com/mcp

Токен выпускается в приложении: Настройки проекта → MCP-токены. Если ещё не выпустили — как это сделать. В примерах ниже mcp_ВАШ_ТОКЕН нужно заменить на реальное значение.

Не вставляйте токен в файлы, которые попадают в git

Часть клиентов умеет читать токен из переменной окружения или спрашивать его при запуске. Где это возможно, такой вариант показан первым — он безопаснее, особенно для файлов вида .vscode/mcp.json и .cursor/mcp.json, которые обычно коммитятся.

Claude Code​

Одна команда в терминале:

claude mcp add --transport http metriox https://api.metriox.com/mcp --header "Authorization: Bearer mcp_ВАШ_ТОКЕН"

Проверить, что сервер подключился:

claude mcp list

Codex CLI​

Откройте ~/.codex/config.toml и добавьте секцию. Предпочтительный вариант — токен в переменной окружения:

[mcp_servers.metriox]
url = "https://api.metriox.com/mcp"
bearer_token_env_var = "METRIOX_MCP_TOKEN"

Затем экспортируйте переменную (в ~/.zshrc, ~/.bashrc или менеджере секретов):

export METRIOX_MCP_TOKEN="mcp_ВАШ_ТОКЕН"

Альтернатива — заголовок прямо в конфиге, если переменную окружения использовать неудобно:

[mcp_servers.metriox]
url = "https://api.metriox.com/mcp"
http_headers = { Authorization = "Bearer mcp_ВАШ_ТОКЕН" }

Есть и третий вариант — env_http_headers, где указывается имя заголовка и имя переменной, из которой брать значение.

Если запросы к аналитике на больших интервалах не успевают за таймаут, поднимите лимиты (по умолчанию — 10 и 60 секунд):

startup_timeout_sec = 20
tool_timeout_sec = 120

GitHub Copilot CLI​

Файл ~/.copilot/mcp-config.json (для всех проектов) либо .mcp.json / .github/mcp.json в корне репозитория:

{
  "mcpServers": {
    "metriox": {
      "type": "http",
      "url": "https://api.metriox.com/mcp",
      "headers": { "Authorization": "Bearer mcp_ВАШ_ТОКЕН" },
      "tools": ["*"]
    }
  }
}

type должен быть http. Значение sse — устаревший транспорт, для Metriox оно не подходит.

Известная ошибка Copilot CLI

Copilot CLI обращается к /.well-known/oauth-authorization-server даже когда заголовок с токеном уже задан, и, не найдя OAuth-конфигурацию, отбрасывает заголовок — подключение падает с ошибкой авторизации. Это ошибка клиента, а не Metriox: github/copilot-cli#3100 (открыта на момент публикации).

Обходной путь: выполните /mcp enable внутри сессии Copilot — так проверка обходится и заголовок применяется.

VS Code (Copilot Chat)​

Нужен VS Code 1.101 или новее. Файл .vscode/mcp.json в проекте или пользовательский mcp.json.

Этот файл обычно коммитится, поэтому токен запрашивается при запуске, а не хранится в нём:

{
  "servers": {
    "metriox": {
      "type": "http",
      "url": "https://api.metriox.com/mcp",
      "headers": { "Authorization": "Bearer ${input:metriox_token}" }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "metriox_token",
      "description": "Metriox MCP token",
      "password": true
    }
  ]
}

VS Code спросит токен при первом запуске сервера и сохранит его в своём хранилище секретов — в файле остаётся только ссылка ${input:metriox_token}.

Обратите внимание: ключ верхнего уровня здесь servers, а не mcpServers, как у Copilot CLI и Cursor.

Cursor​

Файл ~/.cursor/mcp.json (глобально) или .cursor/mcp.json (в проекте). Cursor подставляет ${env:…} и в url, и в headers, поэтому токен держим в переменной окружения:

{
  "mcpServers": {
    "metriox": {
      "url": "https://api.metriox.com/mcp",
      "headers": { "Authorization": "Bearer ${env:METRIOX_MCP_TOKEN}" }
    }
  }
}

claude.ai, Claude Desktop и мобильные приложения​

Подключается как «пользовательский коннектор»:

  1. Откройте Settings → Connectors → Add custom connector
  2. URL: https://api.metriox.com/mcp
  3. Authentication: выберите None
  4. Разверните Request headers и добавьте заголовок:
    • имя: authorization
    • значение: Bearer mcp_ВАШ_ТОКЕН

Значение заголовка передаётся как есть, поэтому слово Bearer и пробел после него обязательны.

Доступно не всем организациям

Передача токена через Request headers находится в бете и открыта не для всех организаций. Если в диалоге добавления коннектора нет секции Request headers — у вашей организации пока нет этой возможности, и подключить Metriox к claude.ai таким способом не получится. Клиенты из списка выше (Claude Code, Codex, Copilot, VS Code, Cursor) работают без этого ограничения.

Настройки авторизации нельзя изменить после добавления

Заголовки и параметры авторизации коннектора не редактируются. Чтобы заменить токен, удалите коннектор и добавьте его заново с новым значением.

Если не подключается​

401 Unauthorized. Токен отозван, просрочен или скопирован не полностью. Проверьте в разделе MCP-токены, что токен активен, и что в заголовке есть префикс Bearer с пробелом.

403 Forbidden. Токен валиден, но у человека, выпустившего его, больше нет нужных прав в проекте — права проверяются при каждом запросе. Проверьте роль этого участника.

Агент не находит нужный инструмент. Доступен тридцать один инструмент — их список на странице Инструменты. Дашборды агент менять умеет, рассылки — только читать.

Инструмент возвращает «бот не найден». Идентификатор бота должен принадлежать тому же проекту, для которого выпущен токен. Получите корректные идентификаторы через metriox_list_bots.

429 Too Many Requests. Сработало ограничение частоты запросов — оно считается отдельно для каждого токена, поэтому агент не мешает вашей работе в браузере. Попросите агента делать запросы реже или с более широкими интервалами.

Copilot CLI падает на авторизации. См. известную ошибку выше.

Команды и пути к файлам проверены по документации соответствующих вендоров. Клиенты меняются — если команда не сработала, сверьтесь с официальной документацией вашей программы.

Последнее обновление