> ## Documentation Index > Fetch the complete documentation index at: https://docs.toapis.com/llms.txt > Use this file to discover all available pages before exploring further. # Подключение через MCP > Подключите AI-агентов к ToAPIs через MCP и генерируйте изображения и видео на 200+ моделях. Подключите ToAPIs через MCP к агентам, которыми вы уже пользуетесь. Вместо копирования API-ключа достаточно войти через браузер. Агент выбирает модель, читает её параметры, отправляет задачу и возвращает результат. > [!NOTE] > > Выберите адрес сайта, на котором находятся ваш аккаунт и баланс. Примеры ниже используют международный сайт. Для аккаунта toapis.cn замените `https://api.toapis.com/mcp` на `https://api.toapis.cn/mcp` и используйте консоль toapis.cn. Аккаунты и баланс двух сайтов раздельные. | Сайт | MCP endpoint | | - | - | | Международный | `https://api.toapis.com/mcp` | | Материковый Китай | `https://api.toapis.cn/mcp` | ## Перед подключением Нужен клиент с поддержкой удалённого MCP через Streamable HTTP. Необязательные ToAPIs skills помогают выбирать модели и составлять промпты. Команды `npx skills add` требуют Node.js, но MCP работает и без установки skills. При авторизации в браузере войдите на соответствующий сайт ToAPIs, проверьте название клиента, выберите API-ключ или создайте отдельный ключ с лимитом расходов и разрешите доступ. Для аутентификации по заголовку создайте отдельный ключ в разделе [API Tokens](https://toapis.com/dashboard/tokens) и замените `` локально. Не отправляйте настоящий ключ в чат и не сохраняйте его в системе контроля версий. ## Выберите клиент и подключитесь за несколько шагов > [accordion] Claude Code > > ### Claude Code > > Выполните команды ниже в терминале. Первая устанавливает необязательные skills, вторая добавляет MCP-сервер. Затем авторизуйтесь через `/mcp` и проверьте подключение командой `claude mcp list`. > > ```bash theme={null} > npx skills add toapis/skills -g --agent claude-code -y > claude mcp add --transport http --scope user toapis https://api.toapis.com/mcp --header "X-Locale: ru" > ``` > > ### Подтвердите в /mcp > > Введите /mcp в Claude Code, выберите toapis и войдите в браузере. Если toapis нет в списке, сначала перезапустите Claude Code. > [accordion] Claude > > ### Добавить вручную > > Откройте Настройки > Коннекторы и добавьте пользовательский коннектор. В поле названия укажите ToAPIs, в поле URL укажите адрес ниже, поля OAuth Client ID и Secret оставьте пустыми. > > ```text theme={null} > https://api.toapis.com/mcp > ``` > > ### Подключите и подтвердите > > Нажмите Add, затем Connect. Войдите на странице ToAPIs, выберите API-ключ и нажмите «Разрешить». > > Claude обращается к ToAPIs с серверов Anthropic, поэтому не выбирайте ключ со списком разрешённых IP. В бесплатном плане можно добавить один пользовательский коннектор. > [accordion] Codex > > ### Codex > > Выполните команды ниже в терминале. Первая устанавливает необязательные skills. При добавлении сервера может открыться браузер: сначала завершите авторизацию. Если `codex mcp list` показывает `Not logged in`, выполните `codex mcp login toapis`, авторизуйтесь и проверьте снова. После настройки начните новый чат. > > ```bash theme={null} > npx skills add toapis/skills -g --agent codex -y > codex mcp add toapis --url https://api.toapis.com/mcp > codex mcp list > ``` > > ### Подтвердите в браузере > > Codex откроет страницу авторизации ToAPIs. Войдите, проверьте название клиента, выберите API-ключ или создайте отдельный с лимитом расходов и нажмите «Разрешить». В приложении можно также нажать Authenticate рядом с toapis в разделе Настройки > MCP servers. > > Codex CLI и приложение для компьютера используют одну конфигурацию, поэтому достаточно настроить один раз. > > [Codex MCP](https://developers.openai.com/codex/mcp/) > [accordion] Cursor > > ### Добавьте ToAPIs > > Добавьте конфигурацию ниже в `~/.cursor/mcp.json`, затем подключитесь в настройках MCP. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "url": "https://api.toapis.com/mcp", > "headers": { > "X-Locale": "ru" > } > } > } > } > ``` > > Необязательная установка skills: > > ```bash theme={null} > npx skills add toapis/skills -g --agent cursor -y > ``` > > ### Войдите > > В настройках MCP в Cursor нажмите Connect рядом с toapis, войдите в ToAPIs в браузере, выберите API-ключ и нажмите «Разрешить». > [accordion] Devin > > ### Добавьте ToAPIs > > Devin Desktop и Devin CLI используют одну конфигурацию. Выполните эти команды в терминале или попросите Devin выполнить их: > > ```bash theme={null} > devin mcp add -s user toapis https://api.toapis.com/mcp > devin mcp login toapis > ``` > > ### Подтвердите в браузере > > devin mcp login toapis откроет браузер: войдите в ToAPIs, выберите API-ключ и нажмите «Разрешить». Если пропустить этот шаг, Devin попросит войти при первом использовании toapis. > [accordion] Antigravity > > ### Добавьте в конфигурацию MCP > > Приложение, IDE и CLI Antigravity используют общий файл `~/.gemini/config/mcp_config.json.` Добавьте в него конфигурацию ниже и сохраните, затем введите /mcp в CLI или перезагрузите серверы в настройках. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "serverUrl": "https://api.toapis.com/mcp", > "headers": { > "X-Locale": "ru" > } > } > } > } > ``` > > Добавьте запись `toapis` в существующую конфигурацию, сохранив другие серверы. > > ### Подтвердите и вставьте код > > Откройте настройки Antigravity сочетанием `Cmd + ,` (`Ctrl + ,` в Windows), перейдите в Customizations и нажмите Authenticate рядом с toapis. После входа в ToAPIs и нажатия «Разрешить» страница покажет код авторизации. Вставьте его в настройки и нажмите Submit. > [accordion] Doubao (豆包) > > ### Создайте отдельный ключ > > Этот клиент поддерживает только ключ в заголовке запроса. Создайте ключ в консоли ToAPIs (лучше с лимитом расходов) и скопируйте его. В конфигурации ниже замените `` этим ключом. > > [Открыть API-токены](https://toapis.com/dashboard/tokens) > > ### Создайте собственный плагин > > Откройте десктопное приложение Doubao, нажмите «插件·技能·伙伴» (плагины, навыки, партнёры) слева, на странице «插件» (плагины) нажмите «+ 添加» (добавить) справа вверху и выберите «新建自定义插件» (новый собственный плагин). Укажите имя сервера ToAPIs, тип транспорта HTTP, а в URL сервера вставьте адрес ниже. > > ```text theme={null} > https://api.toapis.com/mcp > ``` > > ### Добавьте заголовок авторизации и сохраните > > В разделе «自定义 Headers» (свои заголовки) нажмите «+ 添加», укажите имя заголовка Authorization, а в поле значения вставьте строку ниже (замените `` своим ключом), затем нажмите «保存» (сохранить). > > ```text theme={null} > Bearer > ``` > > Добавляйте в десктопном приложении Doubao (Windows или macOS). Доступность собственных плагинов для корпоративных аккаунтов зависит от настроек администратора. > [accordion] QwenWork (千问办公) > > ### Создайте отдельный ключ > > Этот клиент поддерживает только ключ в заголовке запроса. Создайте ключ в консоли ToAPIs (лучше с лимитом расходов) и скопируйте его. В конфигурации ниже замените `` этим ключом. > > [Открыть API-токены](https://toapis.com/dashboard/tokens) > > ### Вставьте JSON-конфигурацию > > В QwenWork откройте слева «扩展» (расширения) > «连接器» (коннекторы), нажмите справа вверху «+ 添加» > «粘贴 JSON 配置» (вставить JSON), вставьте конфигурацию ниже (замените `` своим ключом) и нажмите «导入» (импорт). > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "type": "streamable-http", > "url": "https://api.toapis.com/mcp", > "headers": { > "Authorization": "Bearer ", > "X-Locale": "ru" > } > } > } > } > ``` > > ### Включите коннектор > > По умолчанию коннекторы выключены. Включите toapis в списке и создайте новую задачу: в уже открытых диалогах он работать не будет. > [accordion] Qwen Code > > ### Выполните в терминале > > Первая команда устанавливает навыки ToAPIs (нужен Node.js; MCP работает и без них), вторая добавляет MCP-сервер ToAPIs: > > ```bash theme={null} > npx skills add toapis/skills -g --agent qwen-code -y > qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "X-Locale: ru" > ``` > > ### Авторизуйтесь в браузере > > Запустите Qwen Code командой qwen. При подключении к ToAPIs откроется страница авторизации в браузере: войдите, выберите ключ и нажмите «Разрешить». Введите /mcp в Qwen Code, чтобы проверить подключение и вход для toapis. > > ### Вход через браузер не работает? Используйте API-ключ > > Создайте ключ в разделе «API-токены» консоли, замените им `` в команде ниже и выполните её. > > ```bash theme={null} > qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "Authorization: Bearer " --header "X-Locale: ru" > ``` > [accordion] Trae CN > > ### Создайте отдельный ключ > > Этот клиент поддерживает только ключ в заголовке запроса. Создайте ключ в консоли ToAPIs (лучше с лимитом расходов) и скопируйте его. В конфигурации ниже замените `` этим ключом. > > [Открыть API-токены](https://toapis.com/dashboard/tokens) > > ### Добавьте MCP-сервер вручную > > В Trae откройте «设置» (настройки) > «MCP», в разделе «MCP Servers 管理» нажмите справа вверху «添加» (добавить) > «手动添加» (вручную), вставьте конфигурацию ниже (замените `` своим ключом) и нажмите «确认» (подтвердить). > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "url": "https://api.toapis.com/mcp", > "headers": { > "Authorization": "Bearer ", > "X-Locale": "ru" > } > } > } > } > ``` > > ### Установите навыки (рекомендуется) > > Они помогают агенту выбирать модели и писать промпты (нужен Node.js; MCP работает и без них): > > ```bash theme={null} > npx skills add toapis/skills -g --agent trae-cn -y > ``` > [accordion] WorkBuddy > > ### Добавьте пользовательский коннектор > > В WorkBuddy откройте коннекторы на боковой панели, нажмите «Пользовательский коннектор» в правом верхнем углу, вставьте конфигурацию ниже и сохраните. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "type": "http", > "url": "https://api.toapis.com/mcp" > } > } > } > ``` > > ### Подключите и подтвердите > > Нажмите Trust и Connect, затем войдите на открывшейся странице ToAPIs, выберите API-ключ и нажмите «Разрешить». > [accordion] Другие клиенты > > ### Добавьте удалённый MCP-сервер > > Добавьте удалённый MCP-сервер (Streamable HTTP) с адресом ниже и выберите вход через OAuth. Поля Client ID и Secret оставьте пустыми. > > ```text theme={null} > https://api.toapis.com/mcp > ``` > > ### Нет входа через браузер? > > Некоторые клиенты поддерживают только аутентификацию по заголовку или не могут завершить вход через браузер. Создайте отдельный ключ в консоли и подключитесь с заголовком Authorization: Bearer. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "url": "https://api.toapis.com/mcp", > "headers": { > "Authorization": "Bearer ", > "X-Locale": "ru" > } > } > } > } > ``` ## Проверьте подключение Начните новый чат и отправьте фразу ниже. Если появится баланс, подключение работает (проверка бесплатна). Если агент просит войти, получает ошибку аутентификации или не находит инструменты ToAPIs, проверьте шаги выше. ```text theme={null} Сколько кредитов ToAPIs у меня осталось и сколько я потратил сегодня? ``` ## Что можно делать после подключения Опишите задачу обычными словами. Агент выберет модель, подготовит параметры по документации, отправит задачу и проследит за ней. ### Генерация изображений Изображения по тексту, редактирование по референсам, выбор пропорций и количества. ```text theme={null} Сгенерируй через ToAPIs изображение маяка на рассвете в формате 16:9 ``` ### Генерация видео Видео по тексту и по изображению, по умолчанию рекомендуем Seedance. ```text theme={null} Сделай из этого фото товара вертикальный промо-ролик на 5 секунд ``` ### Локальные файлы Укажите путь к локальному изображению. Агент загрузит его и использует как референс. ```text theme={null} Возьми ./product.png за основу и помести товар на белый фон ``` Перед генерацией агент читает документацию модели, загружает локальные материалы через `create_upload` и следит за прогрессом через `get_generation`. Пока задача выполняется, дождитесь результата вместо повторной отправки. Если ответ на отправку потерян, при повторе используйте прежний `client_request_id`: новый ID может создать ещё одну платную задачу. При состоянии `unknown` сначала проверьте список задач в консоли. Сохраните ссылки на результаты; клиент также может скачать файлы локально. ## Доступные инструменты | Инструмент | Назначение | | - | - | | `list_models` | Список доступных текущему ключу моделей изображений и видео с ценами и `docs_available`. | | `get_model_docs` | Документация параметров перед генерацией. Выберите модель с `docs_available: true`. | | `generate_image` | Генерация изображений. Платно. | | `generate_video` | Генерация видео. Платно. | | `get_generation` | Прогресс и результаты MCP-генерации по `client_request_id`. | | `get_task` | Проверка задачи изображения или видео по `task_id`. | | `create_upload` | Одноразовый URL для загрузки локального изображения, видео или аудио. | | `get_balance` | Лимит ключа и баланс аккаунта. | | `list_tasks` | Последние задачи текущего ключа. | | `get_usage` | Сумма списаний по текущему ключу за период до 31 дня. Возвраты не вычитаются. | ## Частые вопросы > [accordion] Нужен ли API-ключ? > > Копировать его не нужно. При авторизации вы выбираете существующий ключ на странице ToAPIs или создаёте отдельный, а агент использует его через токен доступа. Клиенты, которые поддерживают только аутентификацию по заголовку, могут подключиться по API-ключу. > [accordion] Как происходит оплата? > > Так же, как при вызове API: цена модели списывается с выбранного ключа и кредитов аккаунта. Просмотр моделей, баланса и задач бесплатен. Оплачивается только генерация изображений и видео. > [accordion] Зачем Codex нужен Full access? > > Установка навыков и добавление MCP-сервера записывают данные в конфигурацию Codex на вашем компьютере, а режим разрешений по умолчанию не даёт агенту менять файлы за пределами рабочей папки. Это нужно только для настройки, потом режим можно вернуть. Либо выполните команды в терминале сами. > [accordion] Как отключиться? > > Отключите подключение в разделе «Подключённые приложения» консоли: авторизация будет отозвана, а отдельный ключ, созданный для подключения, отключён (если его не использует другое подключение). Удаление toapis в клиенте, например командой codex mcp remove toapis, стирает только локальную настройку. > [accordion] Чем отличаются toapis.com и toapis.cn? > > У двух сайтов раздельные аккаунты и кредиты. Аккаунты toapis.com используют api.toapis.com/mcp, аккаунты toapis.cn используют api.toapis.cn/mcp. При входе на другом сайте появится сообщение о несовпадении сайта. > [accordion] Какие клиенты поддерживаются? > > Большинство настольных и консольных клиентов с поддержкой удалённого MCP и OAuth можно подключить по инструкции для других клиентов. Если вход не удаётся, подключитесь по API-ключу. Мы будем добавлять шаги для новых клиентов. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.