MCP сервер

Токен не нужен — при первом обращении откроется браузер со страницей входа FreshOffice:

claude mcp add --transport http freshoffice https://mcp.freshoffice.ru/mcp

Инструменты появятся в новой сессии Claude Code. Проверить подключение и пройти авторизацию можно командой /mcp внутри сессии.

По умолчанию сервер добавляется только для текущего проекта. Чтобы он был доступен во всех проектах, добавьте флаг --scope user.

Вариант с токеном (если вход через браузер не подходит, например на сервере):

claude mcp add --transport http freshoffice https://mcp.freshoffice.ru/mcp \
  --header "Authorization: Bearer <токен>"

Сохраните токен в переменную окружения и добавьте сервер в файл конфигурации ~/.codex/config.toml:

export FRESHOFFICE_MCP_TOKEN="<токен>"

[mcp_servers.freshoffice]
url = "https://mcp.freshoffice.ru/mcp"
bearer_token_env_var = "FRESHOFFICE_MCP_TOKEN"
enabled = true

Либо командой через CLI:

codex mcp add freshoffice --url https://mcp.freshoffice.ru/mcp

После этого перезапустите Codex — сервер появится в списке codex mcp list.

Откройте Settings → MCP → Add new MCP Server или создайте файл .cursor/mcp.json в корне проекта (для всех проектов — ~/.cursor/mcp.json):

{
  "mcpServers": {
    "freshoffice": {
      "url": "https://mcp.freshoffice.ru/mcp",
      "headers": {
        "Authorization": "Bearer <токен>"
      }
    }
  }
}

После сохранения сервер появится в списке Settings → MCP — переключатель должен стать зелёным.

В свежих версиях Cursor можно не указывать headers — тогда при подключении откроется страница входа FreshOffice (OAuth).

Создайте файл .vscode/mcp.json в рабочей папке:

{
  "servers": {
    "freshoffice": {
      "type": "http",
      "url": "https://mcp.freshoffice.ru/mcp",
      "headers": {
        "Authorization": "Bearer <токен>"
      }
    }
  }
}

Затем запустите сервер из панели MCP (команда MCP: List Servers в палитре команд).

В свежих версиях VS Code можно не указывать headers — тогда при запуске сервера откроется страница входа FreshOffice (OAuth).

Подойдёт любой MCP-клиент с поддержкой транспорта Streamable HTTP. Если клиент поддерживает OAuth-авторизацию MCP — достаточно указать адрес https://mcp.freshoffice.ru/mcp, вход пройдёт через браузер. Иначе укажите в настройках:

• URL: https://mcp.freshoffice.ru/mcp
• Заголовок: Authorization: Bearer <токен>

Пример прямого вызова для проверки подключения:

curl -X POST https://mcp.freshoffice.ru/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <токен>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

В ответе придёт информация о сервере и его инструкции — значит, подключение работает. Дальнейшие запросы (например, tools/list) отправляются с заголовком Mcp-Session-Id из заголовков этого ответа — MCP-клиенты делают это автоматически.

Платформам, которые пока не поддерживают Streamable HTTP (например, агенты Yandex AI Studio), укажите вместо этого адрес легаси-транспорта HTTP+SSE: https://mcp.freshoffice.ru/mcp/sse — с тем же заголовком авторизации.