Aha.io — MCP-сервер для Claude Code: идеи и релизы Aha
Подключает Aha.io к агенту: поиск, чтение и правка идей, фич, эпиков, релизов, целей и комментариев прямо из чата.
claude mcp add aha-mcp -e AHA_COMPANY=<AHA_COMPANY> -e AHA_TOKEN=<AHA_TOKEN> -- npx -y @cedricziel/aha-mcpЧто делает Aha.io
Сервер даёт агенту доступ к продуктовой базе 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.
Какие задачи решает
- найти идею или фичу в Aha.io по смыслу, а не по точному названию
- прочитать эпик и связанные с ним записи, не открывая браузер
- обновить статус или текст записи прямо из чата с агентом
- собрать список релизов и целей по продукту
- оставить комментарий к идее, не переключаясь в веб-интерфейс
Примеры запросов агенту
- Найди в Aha.io все идеи про экспорт отчётов и покажи их статусы
- Покажи открытые эпики текущего релиза и их прогресс
- Добавь комментарий к идее про тёмную тему: клиенты просят её в мобильном приложении
Как установить Aha.io
Командой платформы
claude mcp add aha-mcp -e AHA_COMPANY=<AHA_COMPANY> -e AHA_TOKEN=<AHA_TOKEN> -- npx -y @cedricziel/aha-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add ahaio --env AHA_COMPANY=<AHA_COMPANY> --env AHA_TOKEN=<AHA_TOKEN> -- npx -y @cedricziel/aha-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ahaio": {
"command": "npx",
"args": [
"-y",
"@cedricziel/aha-mcp"
],
"env": {
"AHA_COMPANY": "<AHA_COMPANY>",
"AHA_TOKEN": "<AHA_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ahaio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cedricziel/aha-mcp"
],
"env": {
"AHA_COMPANY": "<AHA_COMPANY>",
"AHA_TOKEN": "<AHA_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e AHA_COMPANY=<AHA_COMPANY> -e AHA_TOKEN=<AHA_TOKEN> ahaio npx -y @cedricziel/aha-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Aha.io
Как установить Aha.io MCP-сервер в Claude Code?
Одной командой: claude mcp add aha-mcp -e AHA_COMPANY=<AHA_COMPANY> -e AHA_TOKEN=<AHA_TOKEN> -- npx -y @cedricziel/aha-mcp. Подставьте свой поддомен Aha.io и API-токен вместо плейсхолдеров.
Что делает Aha.io MCP-сервер?
Даёт агенту искать, читать и обновлять идеи, фичи, эпики, релизы, цели и комментарии в Aha.io. Запросы идут либо напрямую в API, либо в локальную базу SQLite, которую сервер синхронизирует в фоне.
Что нужно для работы сервера?
Поддомен Aha.io в AHA_COMPANY и API-токен в AHA_TOKEN. Вместо токена можно использовать OAuth-токен в AHA_ACCESS_TOKEN. Для удалённого доступа включается режим streamable-http.
