# One

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

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: withoneai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/withoneai/mcp
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/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.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.withone.ai/mcp`
- Переменные окружения: `ONE_SECRET`, `ONE_PERMISSIONS`, `ONE_CONNECTION_KEYS`, `ONE_ACTION_IDS`, `ONE_KNOWLEDGE_AGENT`, `ONE_IDENTITY`, `ONE_IDENTITY_TYPE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://mcp.withone.ai/mcp
```

2. **Командой платформы**
```bash
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 сервера

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add one --url https://mcp.withone.ai/mcp
```

2. **Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "one": {
            "url": "https://mcp.withone.ai/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "one": {
            "type": "http",
            "url": "https://mcp.withone.ai/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "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 сервера

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http one https://mcp.withone.ai/mcp
```

2. **Командой платформы**
```bash
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 сервера

## Когда брать
- найти API-действие для задачи в подключённых приложениях
- получить документацию к операции перед вызовом
- отправить сообщение через Slack из агента
- выгрузить данные из Gmail, Shopify или Linear
- ограничить действия агента по разрешениям

## Примеры запросов агенту
- Найди действие, которое отправит сообщение в канал Slack, и выполни его.
- Получи последние письма из Gmail и покажи отправителя и тему.
- Собери таблицу счетов QuickBooks с поиском и сортировкой.

## Похожие
- [Celigo](https://affpapa.org/nevibecode/mcp/celigo.md) — MCP-сервер · ★ 4
- [managing-integrations](https://affpapa.org/nevibecode/skills/managing-integrations.md) — скилл · 2700 установок
- [executor-mcp](https://affpapa.org/nevibecode/skills/executor-mcp.md) — скилл · ★ 783
- [cargo-mcp](https://affpapa.org/nevibecode/skills/cargo-mcp.md) — скилл · 4700 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md