# Aha.io

Подключает Aha.io к агенту: поиск, чтение и правка идей, фич, эпиков, релизов, целей и комментариев прямо из чата.

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

## Что делает

Сервер даёт агенту доступ к продуктовой базе Aha.io: он ищет записи, читает их и обновляет. Работает в двух режимах — живой API и локальная база SQLite, которую сервер синхронизирует в фоне. Семантический поиск по записям идёт через векторные эмбеддинги, так что искать можно по смыслу, а не только по точному слову.

Без переменных `AHA_COMPANY` и `AHA_TOKEN` сервер не запустится: первая — ваш поддомен Aha.io, вторая — API-токен. Есть и вариант с OAuth через `AHA_ACCESS_TOKEN`. Транспорт по умолчанию — `stdio`, для удалённого доступа включается `streamable-http` на порту 3001, при желании с Bearer-токеном. Старый транспорт `sse` убран, и конфигурация с ним молча переключается на `streamable-http` с предупреждением.

Настройки читаются в порядке приоритета: переменные окружения, затем файл `~/.aha-mcp-config.json`, затем значения по умолчанию. Есть лимит вызовов инструментов в минуту, по умолчанию 120, ноль его снимает. Для локальной разработки нужен Bun.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add aha-mcp -e AHA_COMPANY=<AHA_COMPANY> -e AHA_TOKEN=<AHA_TOKEN> -- npx -y @cedricziel/aha-mcp
```
Вместо <…> подставьте свои значения

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- найти идею или фичу в Aha.io по смыслу, а не по точному названию
- прочитать эпик и связанные с ним записи, не открывая браузер
- обновить статус или текст записи прямо из чата с агентом
- собрать список релизов и целей по продукту
- оставить комментарий к идее, не переключаясь в веб-интерфейс

## Примеры запросов агенту
- Найди в Aha.io все идеи про экспорт отчётов и покажи их статусы
- Покажи открытые эпики текущего релиза и их прогресс
- Добавь комментарий к идее про тёмную тему: клиенты просят её в мобильном приложении

## Похожие
- [Obsidian Brain](https://affpapa.org/nevibecode/mcp/obsidian-brain.md) — MCP-сервер · ★ 14
- [Sugar](https://affpapa.org/nevibecode/mcp/sugar.md) — MCP-сервер · ★ 98
- [openchronicle-mcp](https://affpapa.org/nevibecode/mcp/openchronicle-mcp.md) — MCP-сервер · ★ 16
- [longhand](https://affpapa.org/nevibecode/plugins/longhand.md) — плагин · ★ 14
- [openviking-memory](https://affpapa.org/nevibecode/skills/openviking-memory.md) — скилл · 504 установки
- [basic-memory](https://affpapa.org/nevibecode/mcp/basic-memory.md) — MCP-сервер · ★ 4362

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