ethora-mcp-server — MCP-сервер для Claude Code
MCP-сервер платформы Ethora: создаёт приложения, чат-комнаты, пользователей и AI-агентов, шлёт сообщения и собирает встраиваемые чат-виджеты прямо из агента.
claude mcp add --transport http ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauthЧто делает 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 не подключится.
Какие задачи решает
- создать приложение и чат-комнаты Ethora без ручных запросов к API
- завести пользователя и получить для него API-ключ
- настроить AI-агента внутри чата
- проиндексировать источники для RAG
- сгенерировать код встраиваемого чат-виджета для сайта
Примеры запросов агенту
- Вызови
ethora-status, потомethora-user-loginиethora-app-list - Создай приложение Ethora и добавь в него чат-комнату
- Сделай эмбед чат-виджета для нашего сайта
Как установить ethora-mcp-server
1Командой платформы: удалённый сервер
claude mcp add --transport http ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauth2Командой платформы
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Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add ethora-mcp-server --url https://mcp.chat.ethora.com/mcp/oauth2Командой платформы
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Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ethora-mcp-server": {
"url": "https://mcp.chat.ethora.com/mcp/oauth"
}
}
}{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ethora-mcp-server": {
"type": "http",
"url": "https://mcp.chat.ethora.com/mcp/oauth"
}
}
}{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauth2Командой платформы
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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ethora-mcp-server
Как установить ethora-mcp-server в Claude Code?
Для хостингового варианта: claude mcp add --transport http ethora-mcp-server https://mcp.chat.ethora.com/mcp/oauth. Для локального stdio-запуска: `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`.
Что делает ethora-mcp-server?
Даёт агенту инструменты платформы Ethora: создание приложений, чат-комнат, пользователей и AI-агентов, отправку сообщений, индексацию RAG-источников и генерацию эмбедов чат-виджетов.
Нужен ли аккаунт Ethora для работы сервера?
Не обязательно. Подключитесь к https://mcp.chat.ethora.com/mcp без учётных данных и вызовите ethora-user-register с email, именем и фамилией — аккаунт создастся, а пароль, API-ключ и connectorUrl вернутся один раз.
