> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://agentinbox.space/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://agentinbox.space/_mcp/server.

# Онбординг агента

> Ресурсы для AI-ассистентов кода, MCP-серверов, навыков и документации, удобной для агентов.

> Всё необходимое, чтобы подключить AI-агента к Agent Inbox — почтовой платформе, созданной для AI-агентов.

Если вы разрабатываете с помощью ИИ, Agent Inbox даёт несколько ресурсов, которые упрощают работу.

## Предварительное условие: API-ключ

Нужен человек, который создаст аккаунт Agent Inbox на [agentinbox-ru.vercel.app/](https://agentinbox-ru.vercel.app/). В кабинете создайте API-ключ. С ним агент сможет создавать ящики, отправлять и получать почту, вести треды и не только.

> **Info**
>
> Бесплатный тариф Agent Inbox пока отсутствует.

## MCP-сервер Agent Inbox

MCP (Model Context Protocol) — открытый протокол, который стандартизирует, как приложения передают контекст LLM. MCP-сервер Agent Inbox даёт агенту инструменты для ящиков, отправки писем, тредов и других операций.

### Настройка

Добавьте в конфигурацию MCP-клиента (Claude Code, Cursor, Codex и т.д.):

```json
{
  "mcpServers": {
    "Agent Inbox": {
      "command": "npx",
      "args": ["-y", "agentinbox-mcp"],
      "env": {
        "AGENTINBOX_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

Можно включить только нужные инструменты через аргумент `--tools`:

```json
{
  "mcpServers": {
    "Agent Inbox": {
      "command": "npx",
      "args": ["-y", "agentinbox-mcp", "--tools", "get_message,send_message,reply_to_message"],
      "env": {
        "AGENTINBOX_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

### Доступные MCP-инструменты

| Инструмент         | Описание                               |
| ------------------ | -------------------------------------- |
| `create_inbox`     | Создать новый почтовый ящик для агента |
| `list_inboxes`     | Список всех ящиков в аккаунте          |
| `get_inbox`        | Детали конкретного ящика               |
| `delete_inbox`     | Удалить ящик                           |
| `send_message`     | Отправить письмо из ящика агента       |
| `reply_to_message` | Ответить на письмо в треде             |
| `forward_message`  | Переслать письмо                       |
| `update_message`   | Обновить метки или статус сообщения    |
| `list_threads`     | Список тредов в ящике                  |
| `get_thread`       | Полный тред с сообщениями              |
| `get_attachment`   | Скачать вложение из письма             |

#### [MCP-сервер на GitHub](https://github.com/PATTERN-AUTOMATION-LAB)

Исходный код, контрибьют и issues.

## Документация Agent Inbox для агентов

Актуальную документацию для агента можно дать тремя способами:

1. **Полный индекс документации**
   Структурированный список страниц с описаниями:
   ```
   https://agentinbox.space/llms.txt
   ```
2. **Вся документация одним файлом**
   Все страницы склеены в один файл для полного контекста:
   ```
   https://agentinbox.space/llms-full.txt
   ```
3. **Markdown-версия любой страницы**
   К URL страницы добавьте `.md`:
   ```
   https://agentinbox.space/quickstart.md
   ```

## Навыки Agent Inbox

Навыки дают агентам специализированные знания для задач. Установите навык Agent Inbox, чтобы ассистент по коду получил полный набор почтовых возможностей:

### Claude Code

```bash
claude-code skills install agentinbox/agentinbox-skills/agentinbox
```

### Cursor

```bash
cursor skills install agentinbox/agentinbox-skills/agentinbox
```

### Codex

```bash
codex skills install agentinbox/agentinbox-skills/agentinbox
```

### Ручная установка

```bash
git clone https://github.com/agentinbox/agentinbox-skills.git ~/.skills/agentinbox
```

Затем задайте API-ключ:

```bash
export AGENTINBOX_API_KEY="your-api-key-here"
```

#### [Навыки на GitHub](https://github.com/agentinbox/agentinbox-skills)

Исходники навыка и полная документация.

## Быстрый старт для агентов

Создайте ящик и отправьте первое письмо в несколько строк:

**`Python`**

```python title="Python"
from agentinbox import Agentinbox

client = Agentinbox(api_key="am_...")
inbox = client.inboxes.create(display_name="My AI Agent")
print(f"Agent email: {inbox.inbox_id}")

# Send an email
client.inboxes.messages.send(
    inbox.inbox_id,
    to="user@example.com",
    subject="Hello from my AI agent",
    text="Hi! I'm an AI agent with my own email address."
)
```

**`TypeScript`**

```typescript title="TypeScript"
import { AgentinboxClient } from "agentinbox";

const client = new AgentinboxClient({ apiKey: "am_..." });
const inbox = await client.inboxes.create({ displayName: "My AI Agent" });
console.log(`Agent email: ${inbox.inboxId}`);

// Send an email
await client.inboxes.messages.send(inbox.inboxId, {
    to: "user@example.com",
    subject: "Hello from my AI agent",
    text: "Hi! I'm an AI agent with my own email address."
});
```

**`CLI`**

```bash title="CLI"
# create an inbox
agentinbox inboxes create --display-name "My AI Agent"

# send an email (replace <inbox_id> with the id from above)
agentinbox inboxes:messages send \
  --inbox-id <inbox_id> \
  --to user@example.com \
  --subject "Hello from my AI agent" \
  --text "Hi! I'm an AI agent with my own email address."
```

### Получение писем и ответы

**`Python`**

```python title="Python"
# List threads in the inbox
threads = client.inboxes.threads.list(inbox_id=inbox.inbox_id)

# Get the latest thread
thread = client.inboxes.threads.get(
    inbox_id=inbox.inbox_id,
    thread_id=threads.threads[0].thread_id
)

# Reply to the latest message
latest_message = thread.messages[-1]
client.inboxes.messages.reply(
    inbox_id=inbox.inbox_id,
    message_id=latest_message.message_id,
    to=[latest_message.from_],
    text="Thanks for your email! I'll look into this."
)
```

**`TypeScript`**

```typescript title="TypeScript"
// List threads in the inbox
const threads = await client.inboxes.threads.list(inbox.inboxId);

// Get the latest thread
const thread = await client.inboxes.threads.get(
    inbox.inboxId,
    threads.threads[0].threadId
);

// Reply to the latest message
const latestMessage = thread.messages[thread.messages.length - 1];
await client.inboxes.messages.reply(
    inbox.inboxId,
    latestMessage.messageId,
    { to: [latestMessage.from], text: "Thanks for your email! I'll look into this." }
);
```

## Интеграции для AI-конструкторов

Agent Inbox подключается к популярным платформам разработки агентов:

#### [Replit](/integrations/replit)

Собирайте почтовых агентов на Replit с нашим шаблоном.

#### [LiveKit](/integrate-livekit-agents)

Добавьте почту к голосовым агентам LiveKit.

#### [OpenClaw](/integrations/openclaw)

Используйте Agent Inbox с агентами OpenClaw.

#### [WebSockets](/websockets)

События почты в реальном времени без вебхуков.

## Чем Agent Inbox отличается от обычных почтовых API

В отличие от классических API под одностороннюю транзакционную рассылку, Agent Inbox заточен под **двустороннюю коммуникацию агентов**:

| Возможность              | Agent Inbox                | Классические почтовые API     |
| ------------------------ | -------------------------- | ----------------------------- |
| Ящики на агента          | ✅ Тысячи через API         | ❌ Общие домены отправки       |
| Приём и разбор писем     | ✅ Нативно, с тредами       | ⚠️ Ограничено или доп. модули |
| Тредовые переписки       | ✅ Полноценный API          | ❌ Не поддерживается           |
| Allowlist/blocklist      | ✅ На уровне ящика          | ❌ Нет                         |
| Мультитенантность (Pods) | ✅ Встроенная изоляция      | ❌ Собирать самим              |
| События WebSocket        | ✅ Поток в реальном времени | ❌ Только вебхуки              |
| Доступ IMAP/SMTP         | ✅ Полный протокол          | ❌ Только API                  |
| Оплата за использование  | ✅ За письмо                | ❌ Подписка за ящик            |

## Дальше

#### [Полное руководство Quickstart](/quickstart)

Пошаговая настройка: переменные окружения и практики.

#### [Справочник API](/api-reference)

Полная интерактивная документация API.

#### [Пример: агент автоответа](/examples/auto-reply-agent)

Агент, который отвечает на письма в реальном времени.

#### [FAQ](/faq)

Ответы на вопросы о почте, доставляемости и паттернах агентов.