One — MCP-сервер для Claude Code: что делает и как установить
One подключает ИИ-агента к приложениям через единый MCP-сервер: он находит нужные API-действия, показывает их документацию и выполняет вызовы.
claude mcp add --transport http mcp https://mcp.withone.ai/mcpЧто делает One
One даёт агенту доступ к действиям в Gmail, Slack, Shopify, HubSpot, Stripe, Linear, QuickBooks и других приложениях. Сервер сначала ищет подходящие операции и документацию к ним, затем выполняет вызов на подключённой платформе. Для этого он предоставляет три инструмента: list_one_integrations, find_one_actions и execute_one_action.
Доступ можно ограничить по подключениям, действиям и уровням разрешений: чтение, запись или администрирование. Запросы проходят через One, а секреты автоматически скрываются. Сервер можно подключить удалённо по адресу https://mcp.withone.ai/mcp через OAuth или запустить локально с пакетом @withone/mcp. Локальная настройка через one init запрашивает API key.
Какие задачи решает
- найти API-действие для задачи в подключённых приложениях
- получить документацию к операции перед вызовом
- отправить сообщение через Slack из агента
- выгрузить данные из Gmail, Shopify или Linear
- ограничить действия агента по разрешениям
Примеры запросов агенту
- Найди действие, которое отправит сообщение в канал Slack, и выполни его.
- Получи последние письма из Gmail и покажи отправителя и тему.
- Собери таблицу счетов QuickBooks с поиском и сортировкой.
Как установить One
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.withone.ai/mcp2Командой платформы
claude mcp add --env ONE_SECRET=<ONE_SECRET> --env ONE_PERMISSIONS=<ONE_PERMISSIONS> --env ONE_CONNECTION_KEYS=<ONE_CONNECTION_KEYS> --env ONE_ACTION_IDS=<ONE_ACTION_IDS> --env ONE_KNOWLEDGE_AGENT=<ONE_KNOWLEDGE_AGENT> --transport stdio one -- npx -y @withone/mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
codex mcp add one --url https://mcp.withone.ai/mcp2Командой платформы
codex mcp add one --env ONE_SECRET=<ONE_SECRET> --env ONE_PERMISSIONS=<ONE_PERMISSIONS> --env ONE_CONNECTION_KEYS=<ONE_CONNECTION_KEYS> --env ONE_ACTION_IDS=<ONE_ACTION_IDS> --env ONE_KNOWLEDGE_AGENT=<ONE_KNOWLEDGE_AGENT> -- npx -y @withone/mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"one": {
"url": "https://mcp.withone.ai/mcp"
}
}
}{
"mcpServers": {
"one": {
"command": "npx",
"args": [
"-y",
"@withone/mcp"
],
"env": {
"ONE_SECRET": "<ONE_SECRET>",
"ONE_PERMISSIONS": "<ONE_PERMISSIONS>",
"ONE_CONNECTION_KEYS": "<ONE_CONNECTION_KEYS>",
"ONE_ACTION_IDS": "<ONE_ACTION_IDS>",
"ONE_KNOWLEDGE_AGENT": "<ONE_KNOWLEDGE_AGENT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"one": {
"type": "http",
"url": "https://mcp.withone.ai/mcp"
}
}
}{
"servers": {
"one": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@withone/mcp"
],
"env": {
"ONE_SECRET": "<ONE_SECRET>",
"ONE_PERMISSIONS": "<ONE_PERMISSIONS>",
"ONE_CONNECTION_KEYS": "<ONE_CONNECTION_KEYS>",
"ONE_ACTION_IDS": "<ONE_ACTION_IDS>",
"ONE_KNOWLEDGE_AGENT": "<ONE_KNOWLEDGE_AGENT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
gemini mcp add -t http one https://mcp.withone.ai/mcp2Командой платформы
gemini mcp add -e ONE_SECRET=<ONE_SECRET> -e ONE_PERMISSIONS=<ONE_PERMISSIONS> -e ONE_CONNECTION_KEYS=<ONE_CONNECTION_KEYS> -e ONE_ACTION_IDS=<ONE_ACTION_IDS> -e ONE_KNOWLEDGE_AGENT=<ONE_KNOWLEDGE_AGENT> one npx -y @withone/mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о One
Как установить One в Claude Code?
Выполните claude mcp add --transport http one https://mcp.withone.ai/mcp. При первом подключении Claude Code откроет авторизацию One через OAuth.
Что делает One?
One находит действия для задачи в подключённых приложениях, возвращает их документацию и выполняет API-вызовы через три MCP-инструмента.
Чем удалённое подключение отличается от локального?
Удалённый сервер работает по https://mcp.withone.ai/mcp и использует OAuth, без npm install и переменной ONE_SECRET. Локальный вариант запускается через @withone/mcp и настраивается с API-параметрами.
