# MCP

Використовуйте Happ із Claude Code, Cursor, ChatGPT та інших AI-інструментів — MCP-сервер, llms.txt, OpenAPI

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

Увесь цей сайт машиночитний. Спрямуйте свій AI-інструмент на нього замість читання вручну.

## MCP server [#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--будь-який-mcp-клієнт]

```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 [#документація-як-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/uk/docs/getting-started/quickstart.md](https://docs.happ.tools/llms.mdx/uk/docs/getting-started/quickstart.md) |

На кожній сторінці також є кнопки **Copy Markdown**, **Open in Claude** та **Open in ChatGPT**.

## API для генерації коду [#api-для-генерації-коду]

| Що                       | URL                                                                        |
| ------------------------ | -------------------------------------------------------------------------- |
| Специфікація OpenAPI 3.0 | [api.happ.tools/api/swagger-json](https://api.happ.tools/api/swagger-json) |
| API-довідник (docs)      | [/uk/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.
```