# Подключение

Source: <https://telegafirst.com/docs/connect>
Locale: ru
releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252
sourceContentDigest: 66908bc184512d681dac5ca31deae82e316ae40f01d858a2d723bfde9bc54d39
Version: 1

Страница для владельца бизнеса: как подключить свой ИИ-ассистент к TelegaFirst за несколько минут. ИИ сможет вести бизнес вместе с вами — каталог, заказы, рассылки, воронки и настройки — обычными просьбами в чате. Паролей и ключей нет: вход подтверждается в Telegram. Подробное руководство для ИИ-агента — [Как начать](https://telegafirst.com/docs/getting-started).

## Один промпт — и всё готово <!-- tgf-anchor: how -->

Скопируйте промпт и вставьте его в новый чат со своим ИИ. Дальше ИИ сам прочитает документацию, подключится к TelegaFirst и расскажет, что умеет.

```text
Помоги мне подключить TelegaFirst — AI-фронт-офис в Telegram — и вести через тебя мой бизнес.

1. Прочитай инструкцию по подключению: https://telegafirst.ru/docs/getting-started
2. Подключи MCP-сервер TelegaFirst: https://mcp.telegafirst.com/api/v1/mcp. Если ты умеешь сам добавлять MCP-серверы — добавь его. Если нет — дай мне точную пошаговую инструкцию, как добавить свой (custom) MCP-сервер именно в твоём приложении.
3. Когда понадобится вход, предупреди меня: я подтвержу его в Telegram.
4. После подключения вызови get_onboarding_state с intent: auto и следуй next_action — он подскажет, создаём ли мы новый бизнес или продолжаем существующий.
5. Коротко расскажи, что нашёл, и спроси, с чего я хочу начать.
```

## Вход — через Telegram <!-- tgf-anchor: signin -->

Когда ИИ попросит войти, подтвердите вход в Telegram: отсканируйте QR-код или нажмите кнопку в чате с ботом. Отказ завершает вход. Подробности — [авторизация](https://telegafirst.com/docs/authorization).

## Пошагово для вашего ИИ <!-- tgf-anchor: clients -->

Подойдёт любой ИИ, который умеет подключать MCP-серверы. Везде нужен один и тот же MCP-адрес:

```text
https://mcp.telegafirst.com/api/v1/mcp
```

### ChatGPT

1. Откройте Settings → Security and login и включите Developer mode.
2. В разделе Plugins нажмите «+», назовите подключение TelegaFirst и вставьте MCP-адрес.
3. Создайте подключение и подтвердите вход в Telegram.
4. В новом чате включите TelegaFirst в меню инструментов и вставьте промпт.

Developer mode зависит от тарифа и политики рабочего пространства. [Подробная инструкция](https://telegafirst.com/docs/connect-chatgpt).

### Claude web и Claude Desktop

1. В Claude откройте Customize → Connectors → «+» → Add custom connector.
2. Назовите подключение TelegaFirst, вставьте MCP-адрес и нажмите Add.
3. Нажмите Connect и подтвердите вход в Telegram.
4. В разговоре включите коннектор через «+» → Connectors и вставьте промпт.

В Team и Enterprise коннектор сначала добавляет владелец организации. [Подробная инструкция](https://telegafirst.com/docs/connect-claude-ai).

### Claude Code

1. В терминале добавьте сервер: `claude mcp add --transport http telegafirst https://mcp.telegafirst.com/api/v1/mcp`.
2. Запустите Claude Code и введите команду `/mcp`.
3. Выберите TelegaFirst, пройдите вход в браузере и подтвердите его в Telegram.
4. Вставьте промпт в чат Claude Code.

[Подробная инструкция](https://telegafirst.com/docs/connect-claude-code).

### Codex

1. В терминале добавьте сервер: `codex mcp add telegafirst --url https://mcp.telegafirst.com/api/v1/mcp`.
2. Войдите и подтвердите вход в Telegram: `codex mcp login telegafirst`.
3. Проверьте, что сервер в списке: `codex mcp list` или `/mcp` в чате Codex.
4. Вставьте промпт в чат Codex.

[Подробная инструкция](https://telegafirst.com/docs/connect-codex).

### Cursor

1. Откройте `~/.cursor/mcp.json` и добавьте TelegaFirst, не удаляя другие записи.
2. В настройках MCP Cursor включите TelegaFirst.
3. Пройдите предложенный вход и подтвердите его в Telegram.
4. Вставьте промпт в чат агента.

```json
{"mcpServers":{"telegafirst":{"url":"https://mcp.telegafirst.com/api/v1/mcp"}}}
```

[Подробная инструкция](https://telegafirst.com/docs/connect-cursor).

### Antigravity

1. В панели агента откройте «…» → MCP Servers → Manage MCP Servers → View raw config.
2. Добавьте TelegaFirst, не удаляя другие записи.
3. Откройте Agent Settings → Customizations, нажмите Authenticate у TelegaFirst и подтвердите вход в Telegram.
4. Вставьте промпт в чат агента.

```json
{"mcpServers":{"telegafirst":{"serverUrl":"https://mcp.telegafirst.com/api/v1/mcp"}}}
```

[Подробная инструкция](https://telegafirst.com/docs/connect-antigravity).

### Gemini

1. Откройте веб-версию Gemini → Settings → Connected Apps.
2. В разделе Custom apps добавьте приложение и вставьте MCP-адрес.
3. Нажмите Next, пройдите вход и подтвердите его в Telegram.
4. В запросе введите `@`, выберите TelegaFirst и вставьте промпт.

Custom apps доступны не всем: нужен личный аккаунт Google, возраст от 18 лет и нахождение в США, а сама функция работает на английском. [Подробная инструкция и границы поддержки](https://telegafirst.com/docs/connect-gemini-spark).