# Heliyos

MCP-сервер для Claude Code связывает ИИ-агента с рабочим пространством Heliyos. Агент может искать и менять записи CRM, вести задачи и заметки, а также запускать AI-работников.

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

## Что делает

Heliyos подключает ИИ-агента к CRM и рабочему пространству через API. Агент может находить и редактировать компании, контакты и сделки, читать историю записей, создавать задачи и заметки. Он также управляет скаутами и базой знаний, а через `heliyos_ask` передаёт работу Heliyos и отслеживает её выполнение.

Сервер запускается локально через `npx` по протоколу stdio. Для работы нужны Node.js 20 или новее и ключ API рабочего пространства Heliyos; ключ передаётся через `HELIYOS_API_KEY`. Важные действия работников проходят проверку в Heliyos. Ключ имеет права администратора в одном рабочем пространстве.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `HELIYOS_API_KEY`, `HELIYOS_BASE_URL`, `HELIYOS_MCP_EXPERIMENTAL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env HELIYOS_API_KEY=<HELIYOS_API_KEY> --env HELIYOS_BASE_URL=<HELIYOS_BASE_URL> --env HELIYOS_MCP_EXPERIMENTAL=<HELIYOS_MCP_EXPERIMENTAL> --transport stdio heliyos -- npx -y @heliyos/heliyos-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add heliyos --env HELIYOS_API_KEY=<HELIYOS_API_KEY> --env HELIYOS_BASE_URL=<HELIYOS_BASE_URL> --env HELIYOS_MCP_EXPERIMENTAL=<HELIYOS_MCP_EXPERIMENTAL> -- npx -y @heliyos/heliyos-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "heliyos": {
            "command": "npx",
            "args": [
                "-y",
                "@heliyos/heliyos-mcp"
            ],
            "env": {
                "HELIYOS_API_KEY": "<HELIYOS_API_KEY>",
                "HELIYOS_BASE_URL": "<HELIYOS_BASE_URL>",
                "HELIYOS_MCP_EXPERIMENTAL": "<HELIYOS_MCP_EXPERIMENTAL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "heliyos": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@heliyos/heliyos-mcp"
            ],
            "env": {
                "HELIYOS_API_KEY": "<HELIYOS_API_KEY>",
                "HELIYOS_BASE_URL": "<HELIYOS_BASE_URL>",
                "HELIYOS_MCP_EXPERIMENTAL": "<HELIYOS_MCP_EXPERIMENTAL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e HELIYOS_API_KEY=<HELIYOS_API_KEY> -e HELIYOS_BASE_URL=<HELIYOS_BASE_URL> -e HELIYOS_MCP_EXPERIMENTAL=<HELIYOS_MCP_EXPERIMENTAL> heliyos npx -y @heliyos/heliyos-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти и изменить компанию, контакт или сделку в CRM
- прочитать историю изменений и встречи по записи
- создать заметку или задачу в Heliyos
- передать задачу работнику Heliyos и следить за запуском
- просмотреть сигналы скаутов и обновить список наблюдения

## Примеры запросов агенту
- Найди сделку Acme в Heliyos и обнови её статус.
- Создай в Heliyos задачу по итогам последней встречи с Acme.
- Передай Heliyos задачу проверить новые сигналы скаутов и покажи ход выполнения.

## Похожие
- [Context7](https://affpapa.org/nevibecode/mcp/context7.md) — MCP-сервер · 5563 установки
- [Search Google Flights](https://affpapa.org/nevibecode/mcp/search-google-flights.md) — MCP-сервер · 2595 установок
- [Math-MCP](https://affpapa.org/nevibecode/mcp/math-mcp.md) — MCP-сервер · 5958 установок
- [pipeworx gateway](https://affpapa.org/nevibecode/mcp/pipeworx-gateway.md) — MCP-сервер · 419019 установок
- [SparkForge](https://affpapa.org/nevibecode/mcp/sparkforge.md) — MCP-сервер · 219896 установок
- [OpenWebSearch](https://affpapa.org/nevibecode/mcp/openwebsearch.md) — MCP-сервер · 494 установки

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