diff --git a/CLAUDE.md b/CLAUDE.md
index e679650..3c80792 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -8,7 +8,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
- `alfy-bot/` — NestJS-бэкенд (порт 3002): REST API под `/api`, Swagger на `/api/docs`, Telegram-бот (telegraf), TypeORM + SQLite (`data/database.sqlite`, `synchronize: true`), JWT + API-token auth (`JwtOrApiTokenGuard`), web-push.
- `alfy-bot-frontend/` — Vue 3 + Vite + TS + Tailwind v4 + Pinia + vue-router. PWA (`vite-plugin-pwa`, кастомный `sw.ts`). Запускается как обычный SPA и как Telegram WebApp.
-- `alfy-mcp/` — MCP-сервер (порт 3003, ESM, Node 22+): тонкая обёртка над REST `alfy-bot` для Claude Desktop/Code и удалённых MCP-клиентов. Транспорты: stdio + Streamable HTTP (endpoint `/mcp`). Auth — API-токены, выдаваемые ботом (`/mcp_token `). Не ходит в БД напрямую.
+- `alfy-mcp/` — MCP-сервер (порт 3003, ESM, Node 22+): тонкая обёртка над REST `alfy-bot` для Claude Desktop/Code и удалённых MCP-клиентов. Транспорты: stdio + Streamable HTTP (endpoint `/mcp`). Auth — API-токены, выдаваемые в настройках веб-приложения или ботом (`/mcp_token `). Не ходит в БД напрямую.
- `docker-compose.yml` + `Caddyfile` — прод: Caddy на 80/443 раздаёт `tracker.rocketup.tech`, проксирует `/api/*` на backend, `/mcp` + `/mcp/*` на alfy-mcp, остальное на frontend (nginx).
- `scripts/tunnels.sh` — Cloudflare Quick Tunnels для dev (см. README).
@@ -57,7 +57,7 @@ npm run test # vitest run
npm run lint # eslint .
```
-ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `StreamableHTTPServerTransport`). Auth — API-токены через бот (`/mcp_token `), хранятся как bcrypt-хеш + 10-char prefix-index в БД (`api_token` entity). Tools — тонкая обёртка над REST `alfy-bot` (1 HTTP-вызов на tool, кроме `get_progress` — 3 параллельных). См. `alfy-mcp/README.md` для подключения из клиентов.
+ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `StreamableHTTPServerTransport`). Auth — API-токены из настроек профиля или Telegram-команды `/mcp_token `, хранятся как bcrypt-хеш + 10-char prefix-index в БД (`api_token` entity). В настройках токен показывается только при выдаче, затем доступен только его префикс; отзыв прекращает доступ. Управление токенами через `/api/auth/api-tokens` доступно только с JWT, не с API-токеном. Для HTTP-клиентов адрес в production — `https://tracker.rocketup.tech/mcp`, локально — `http://localhost:3003/mcp`; `VITE_MCP_URL` задаёт адрес в инструкции фронта, без неё используется `/mcp` текущего origin. Tools — тонкая обёртка над REST `alfy-bot` (1 HTTP-вызов на tool, кроме `get_progress` — 3 параллельных). См. `alfy-mcp/README.md` для подключения из клиентов.
**MCP-планирование спринтов.** `tools/sprints.ts` регистрируется в общем `createServer` для обоих транспортов. Контроллеры спринтов и групп используют `JwtOrApiTokenGuard`, иначе MCP API-токен получает 401. `move_story_to_sprint` вызывает атомарный серверный перенос; не заменять его циклом обновления задач. `complete_sprint` требует явный `moveTo`, `delete_sprint` — `confirm: true`. У задач доступны `groupId`/`sprintId` и фильтр `sprint_id`; создание без `sprintId` наследует спринт истории. Контракты проверяются через реальный MCP SDK в `alfy-mcp/tests/tools/sprints.spec.ts` и HTTP-тест API-токена в `alfy-bot/test/story-sprint.e2e-spec.ts`.
diff --git a/README.md b/README.md
index 0908884..b4a9798 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@
## Чем интересен проект
-- **🤖 AI-native через MCP.** Отдельный [MCP-сервер](alfy-mcp/) даёт Claude Desktop / Claude Code полный набор инструментов для управления задачами, целями и привычками. Можно сказать ассистенту «создай цель на квартал и распиши привычки» — и он сделает это через типизированные tools, а не парсинг текста. Транспорты stdio и Streamable HTTP, авторизация по API-токенам из бота.
+- **🤖 AI-native через MCP.** Отдельный [MCP-сервер](alfy-mcp/) даёт Claude Desktop / Claude Code полный набор инструментов для управления задачами, целями и привычками. Можно сказать ассистенту «создай цель на квартал и распиши привычки» — и он сделает это через типизированные tools, а не парсинг текста. Транспорты stdio и Streamable HTTP, авторизация по API-токенам из настроек профиля или бота.
- **🎯 Цели → привычки → честный self-report.** Цель раскладывается на вопросы-привычки с расписанием (ежедневно / по дням недели / с интервалом). Семь типов вопросов: текст, оценка числом, оценка смайликами, да/нет, число, затраченное время, фото. Данные опроса — основа для аналитики и коучинга, а не «галочка выполнено».
- **📱 Три поверхности, один бэкенд.** Telegram-бот (telegraf), Telegram WebApp и обычный SPA — всё работает поверх одного REST API. Веб собран как PWA (offline, web-push, установка на домашний экран).
- **🧱 Чистая архитектура.** Бэкенд — Clean Architecture по модулям (порты в `domain/`, адаптеры в `infrastructure/`, оркестрация в сервисах). Фронтенд — Feature-Sliced Design. Границы слоёв реальны, а не декоративны.
diff --git a/alfy-bot-frontend/.env.example b/alfy-bot-frontend/.env.example
index 410f14d..ee9aa35 100644
--- a/alfy-bot-frontend/.env.example
+++ b/alfy-bot-frontend/.env.example
@@ -1,4 +1,5 @@
VITE_API_URL=http://localhost:3002/api
+VITE_MCP_URL=http://localhost:3003/mcp
# Dev auth (no WebApp): VITE_DEV_USE_WIDGET=true|false
# true: Login Widget on /login (backend: BOT_TOKEN for widget validation)
diff --git a/alfy-bot-frontend/src/features/mcp/api/tokens.ts b/alfy-bot-frontend/src/features/mcp/api/tokens.ts
new file mode 100644
index 0000000..6ad4994
--- /dev/null
+++ b/alfy-bot-frontend/src/features/mcp/api/tokens.ts
@@ -0,0 +1,18 @@
+import type { CreatedMcpToken, McpToken } from '../model/types'
+import { api } from '@/api/client'
+
+const path = '/auth/api-tokens'
+
+export async function listTokens(): Promise {
+ const { data } = await api.get(path)
+ return data
+}
+
+export async function createToken(name: string): Promise {
+ const { data } = await api.post(path, { name })
+ return data
+}
+
+export async function revokeToken(id: number): Promise {
+ await api.delete(`${path}/${id}`)
+}
diff --git a/alfy-bot-frontend/src/features/mcp/lib/connection-guide.ts b/alfy-bot-frontend/src/features/mcp/lib/connection-guide.ts
new file mode 100644
index 0000000..85b03de
--- /dev/null
+++ b/alfy-bot-frontend/src/features/mcp/lib/connection-guide.ts
@@ -0,0 +1,22 @@
+export interface ConnectionGuide {
+ codex: string
+ claudeCode: string
+ generic: string
+}
+
+export function resolveMcpUrl(override: string | undefined, origin: string): string {
+ const url = override?.trim() ? new URL(override.trim()) : new URL('/mcp', origin)
+ if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.hash) {
+ throw new Error('Адрес MCP должен использовать HTTP или HTTPS без логина и фрагмента')
+ }
+ return url.toString()
+}
+
+export function buildConnectionGuide(url: string): ConnectionGuide {
+ const encodedUrl = JSON.stringify(url)
+ return {
+ codex: `[mcp_servers.alfy]\nurl = ${encodedUrl}\nbearer_token_env_var = "ALFY_MCP_TOKEN"`,
+ claudeCode: JSON.stringify({ mcpServers: { alfy: { type: 'http', url, headers: { Authorization: `Bearer \${ALFY_MCP_TOKEN}` } } } }, null, 2),
+ generic: JSON.stringify({ type: 'http', url, headers: { Authorization: 'Bearer YOUR_ALFY_TOKEN' } }, null, 2),
+ }
+}
diff --git a/alfy-bot-frontend/src/features/mcp/model/types.ts b/alfy-bot-frontend/src/features/mcp/model/types.ts
new file mode 100644
index 0000000..7a1c9f9
--- /dev/null
+++ b/alfy-bot-frontend/src/features/mcp/model/types.ts
@@ -0,0 +1,12 @@
+export interface McpToken {
+ id: number
+ name: string
+ prefix: string
+ created_at: string
+ last_used_at: string | null
+}
+
+export interface CreatedMcpToken {
+ id: number
+ plaintext: string
+}
diff --git a/alfy-bot-frontend/src/features/mcp/model/useMcpTokens.ts b/alfy-bot-frontend/src/features/mcp/model/useMcpTokens.ts
new file mode 100644
index 0000000..552544f
--- /dev/null
+++ b/alfy-bot-frontend/src/features/mcp/model/useMcpTokens.ts
@@ -0,0 +1,78 @@
+import type { CreatedMcpToken, McpToken } from './types'
+import { ref } from 'vue'
+import { createToken, listTokens, revokeToken } from '../api/tokens'
+
+export function useMcpTokens() {
+ const tokens = ref([])
+ const revealed = ref(null)
+ const loading = ref(false)
+ const creating = ref(false)
+ const revokingId = ref(null)
+ const loadError = ref(null)
+ const createError = ref(null)
+ const revokeError = ref(null)
+
+ async function fetchTokens(): Promise {
+ if (loading.value)
+ return
+ loading.value = true
+ loadError.value = null
+ try {
+ tokens.value = await listTokens()
+ }
+ catch {
+ loadError.value = 'Не удалось загрузить список токенов'
+ }
+ finally {
+ loading.value = false
+ }
+ }
+
+ async function refresh(): Promise {
+ if (creating.value || revokingId.value !== null)
+ return
+ await fetchTokens()
+ }
+
+ async function create(name: string): Promise {
+ if (creating.value || loading.value || revokingId.value !== null || !name.trim())
+ return
+ creating.value = true
+ createError.value = null
+ try {
+ revealed.value = await createToken(name.trim())
+ await fetchTokens()
+ }
+ catch {
+ createError.value = 'Не удалось создать токен. Обновите список и отзовите лишний токен, если запрос всё же прошёл.'
+ }
+ finally {
+ creating.value = false
+ }
+ }
+
+ async function revoke(id: number): Promise {
+ if (revokingId.value !== null || loading.value || creating.value)
+ return
+ revokingId.value = id
+ revokeError.value = null
+ try {
+ await revokeToken(id)
+ tokens.value = tokens.value.filter(token => token.id !== id)
+ if (revealed.value?.id === id)
+ revealed.value = null
+ }
+ catch {
+ revokeError.value = 'Не удалось отозвать токен'
+ }
+ finally {
+ revokingId.value = null
+ }
+ }
+
+ function dismissSecret(): void {
+ revealed.value = null
+ }
+
+ return { tokens, revealed, loading, creating, revokingId, loadError, createError, revokeError, refresh, create, revoke, dismissSecret }
+}
diff --git a/alfy-bot-frontend/src/features/mcp/ui/McpConnectionGuide.vue b/alfy-bot-frontend/src/features/mcp/ui/McpConnectionGuide.vue
new file mode 100644
index 0000000..64fa30a
--- /dev/null
+++ b/alfy-bot-frontend/src/features/mcp/ui/McpConnectionGuide.vue
@@ -0,0 +1,77 @@
+
+
+
+
+
+ Подключение агента
+
+
+ Сервер MCP: {{ url }}
+
+
+ {{ configError }}
+
+
+
+ Добавьте секцию Codex в ~/.codex/config.toml или запись alfy в mcpServers файла .mcp.json в корне проекта Claude Code. Существующие настройки сохраните. Выполните команды ниже в Bash или Zsh, затем вставьте токен и нажмите Enter: ввод скрыт и не попадает в историю команд. Запустите агента из этого же терминала; в Claude Code проверьте подключение командой /mcp. Конфигурации используют переменную ALFY_MCP_TOKEN.
+