# ethora-mcp-server

MCP-сервер платформы Ethora: создаёт приложения, чат-комнаты, пользователей и AI-агентов, шлёт сообщения и собирает встраиваемые чат-виджеты прямо из агента.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: dappros
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dappros/ethora-mcp-server
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/ethora-mcp-server

## Что делает

Ethora — открытая платформа чатов со встроенным фреймворком AI-агентов. Этот сервер открывает её API инструментам: агент вызывает `ethora-app-create`, `ethora-user-register`, `ethora-app-list` и другие методы, а не ходит в API руками. Через него же индексируются источники для RAG и генерируются эмбеды чат-виджетов для сайта.

Запускать можно тремя способами. Хостинг Ethora Cloud — адрес `https://mcp.chat.ethora.com/mcp`, вход через браузер, ставить локально нечего. Самохостинг идёт в составе monoserver-развёртывания Ethora: включите `services.mcp.enabled` в `deploy.yml`, и сервер поднимется на `mcp.<your domain>/mcp`. Третий вариант — stdio-режим, `npx -y @ethora/mcp-server` с переменными окружения. Хостинг и самохостинг — один и тот же сервер, запущенный с `ETHORA_MCP_TRANSPORT=http`.

Сессии изолированы: логин, выбранное приложение и токены одного клиента не видны другому. Но некоторые клиенты (ChatGPT) открывают новую сессию на каждый вызов инструмента, поэтому сервер держит снимок состояния по аккаунту из bearer-токена — текущее приложение, агент, appToken и включённые группы инструментов. Снимок живёт в процессе и истекает после 24 часов простоя. Для stdio нужны `ETHORA_API_URL` и `ETHORA_APP_JWT`; без них сервер к API не подключится.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.chat.ethora.com/mcp/oauth`
- Переменные окружения: `ETHORA_API_URL`, `ETHORA_BASE_URL`, `ETHORA_APP_JWT`, `ETHORA_B2B_TOKEN`, `ETHORA_MCP_ENABLE_DANGEROUS_TOOLS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauth
```

2. **Командой платформы**
```bash
claude mcp add --env ETHORA_API_URL=<ETHORA_API_URL> --env ETHORA_BASE_URL=<ETHORA_BASE_URL> --env ETHORA_APP_JWT=<ETHORA_APP_JWT> --env ETHORA_B2B_TOKEN=<ETHORA_B2B_TOKEN> --env ETHORA_MCP_ENABLE_DANGEROUS_TOOLS=<ETHORA_MCP_ENABLE_DANGEROUS_TOOLS> --transport stdio ethora-mcp-server -- npx -y @ethora/mcp-server
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add ethora-mcp-server --url https://mcp.chat.ethora.com/mcp/oauth
```

2. **Командой платформы**
```bash
codex mcp add ethora-mcp-server --env ETHORA_API_URL=<ETHORA_API_URL> --env ETHORA_BASE_URL=<ETHORA_BASE_URL> --env ETHORA_APP_JWT=<ETHORA_APP_JWT> --env ETHORA_B2B_TOKEN=<ETHORA_B2B_TOKEN> --env ETHORA_MCP_ENABLE_DANGEROUS_TOOLS=<ETHORA_MCP_ENABLE_DANGEROUS_TOOLS> -- npx -y @ethora/mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ethora-mcp-server": {
            "url": "https://mcp.chat.ethora.com/mcp/oauth"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ethora-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@ethora/mcp-server"
            ],
            "env": {
                "ETHORA_API_URL": "<ETHORA_API_URL>",
                "ETHORA_BASE_URL": "<ETHORA_BASE_URL>",
                "ETHORA_APP_JWT": "<ETHORA_APP_JWT>",
                "ETHORA_B2B_TOKEN": "<ETHORA_B2B_TOKEN>",
                "ETHORA_MCP_ENABLE_DANGEROUS_TOOLS": "<ETHORA_MCP_ENABLE_DANGEROUS_TOOLS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ethora-mcp-server": {
            "type": "http",
            "url": "https://mcp.chat.ethora.com/mcp/oauth"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ethora-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ethora/mcp-server"
            ],
            "env": {
                "ETHORA_API_URL": "<ETHORA_API_URL>",
                "ETHORA_BASE_URL": "<ETHORA_BASE_URL>",
                "ETHORA_APP_JWT": "<ETHORA_APP_JWT>",
                "ETHORA_B2B_TOKEN": "<ETHORA_B2B_TOKEN>",
                "ETHORA_MCP_ENABLE_DANGEROUS_TOOLS": "<ETHORA_MCP_ENABLE_DANGEROUS_TOOLS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauth
```

2. **Командой платформы**
```bash
gemini mcp add -e ETHORA_API_URL=<ETHORA_API_URL> -e ETHORA_BASE_URL=<ETHORA_BASE_URL> -e ETHORA_APP_JWT=<ETHORA_APP_JWT> -e ETHORA_B2B_TOKEN=<ETHORA_B2B_TOKEN> -e ETHORA_MCP_ENABLE_DANGEROUS_TOOLS=<ETHORA_MCP_ENABLE_DANGEROUS_TOOLS> ethora-mcp-server npx -y @ethora/mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- создать приложение и чат-комнаты Ethora без ручных запросов к API
- завести пользователя и получить для него API-ключ
- настроить AI-агента внутри чата
- проиндексировать источники для RAG
- сгенерировать код встраиваемого чат-виджета для сайта

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md