# MCP

Используйте Happ из Claude Code, Cursor, ChatGPT и других AI-инструментов — MCP-сервер, llms.txt, OpenAPI

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Всё на этом сайте машиночитаемо. Вместо того чтобы читать документацию вручную, передайте её своему AI-инструменту.

## MCP-сервер [#mcp-server]

Сервер [`@happ-ai/platform-mcp`](https://www.npmjs.com/package/@happ-ai/platform-mcp) открывает доступ к платформе Happ в виде инструментов: управление компаниями, агентами, каналами, чатами, базой знаний и не только — прямо из вашего AI-ассистента.

### Claude Code [#claude-code]

```bash
claude mcp add -s user happ -- npx -y @happ-ai/platform-mcp@latest
```

Оставляйте суффикс `@latest`: без него npx закрепляет первую скачанную версию и новую уже не подхватывает.

### Cursor / Windsurf / любой MCP-клиент [#cursor--windsurf--any-mcp-client]

```json
{
  "mcpServers": {
    "happ": {
      "command": "npx",
      "args": ["-y", "@happ-ai/platform-mcp@latest"]
    }
  }
}
```

### OpenAI Agents SDK [#openai-agents-sdk]

```python
from agents.mcp import MCPServerStdio

happ = MCPServerStdio(params={
    "command": "npx",
    "args": ["-y", "@happ-ai/platform-mcp@latest"],
})
```

Затем войдите через инструмент `happ_login` или укажите access token из [my.happ.tools](https://my.happ.tools).

## Документация в Markdown [#docs-as-markdown]

| Что                           | URL                                                                                                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Индекс всех страниц           | [/llms.txt](https://docs.happ.tools/llms.txt)                                                                                                                                             |
| Вся документация одним файлом | [/llms-full.txt](https://docs.happ.tools/llms-full.txt)                                                                                                                                   |
| Любая страница в Markdown     | добавьте к пути префикс `/llms.mdx` и суффикс `.md` — например, [/llms.mdx/en/docs/getting-started/quickstart.md](https://docs.happ.tools/llms.mdx/en/docs/getting-started/quickstart.md) |

На каждой странице документации также есть кнопки **Копировать Markdown**, **Open in Claude** и **Open in ChatGPT**.

## API для генерации кода [#api-for-code-generation]

| Что                           | URL                                                                        |
| ----------------------------- | -------------------------------------------------------------------------- |
| Спецификация OpenAPI 3.0      | [api.happ.tools/api/swagger-json](https://api.happ.tools/api/swagger-json) |
| Справочник API (документация) | [/ru/api](/api)                                                            |
| Интерактивный клиент          | [api.happ.tools/reference](https://api.happ.tools/reference)               |

Передайте спецификацию OpenAPI своему инструменту и попросите сгенерировать интеграцию:

```text
Read https://api.happ.tools/api/swagger-json and write a client that
creates an assistant, uploads knowledge, and connects a Telegram bot.
Authenticate with the X-Access-Token header.
```