propyte-mejoras-mcp

Stdio-мост для доски улучшений ИИ Propyte. Позволяет Claude Desktop, Claude Code и любому MCP-клиенту, который говорит на stdio, читать и писать в доску hub.propyte.com.

Что это и что это не

Этот пакет не реализует ни одного инструмента. Он транслирует транспорт и ничего больше: клиент говорит на JSON-RPC построчно в stdin, а шлюз Hub — по POST.

Claude Desktop / Claude Code
        │  stdio (JSON-RPC por líneas)
        ▼
  propyte-mejoras-mcp          ← este paquete: 250 líneas, cero dependencias
        │  HTTPS POST + Authorization: Bearer
        ▼
  hub.propyte.com/api/mcp/mejoras
        │
        ▼
  el tablero (ai_tasks)

Инструменты, их валидация и повторное чтение после записи живут в Hub. Два практических следствия:

• Когда Hub публикует новые инструменты, они появляются сами в твоём клиенте. Не нужно обновлять этот пакет.

• Не существует второй копии правил доски, которая могла бы рассинхронизироваться с правилами Hub.

Если ты используешь Claude Cowork или claude.ai, это тебе не нужно: там URL добавляется напрямую как пользовательский коннектор. Этот мост существует для клиентов, которые говорят только на stdio.

Related MCP server: mcp-streaming-http-proxy

Установка

Требуется Node 20 или выше. Не нужно ничего компилировать или устанавливать зависимости.

1. Получи токен

Он копируется с hub.propyte.com/mejoras/conectar (нужно быть ADMIN или DIRECTOR). На этом экране также показана дата последней ротации.

Не проси токен в чате и не копируй его из документа: экран — единственный источник, который знает, действителен ли секрет.

2. Настрой свой клиент

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "propyte-mejoras": {
      "command": "npx",
      "args": ["-y", "github:Propyte-Luis/propyte-mejoras-mcp"],
      "env": {
        "MCP_MEJORAS_TOKEN": "el-token-de-/mejoras/conectar"
      }
    }
  }
}

Claude Code — одна строка:

claude mcp add propyte-mejoras \
  --env MCP_MEJORAS_TOKEN=el-token-de-/mejoras/conectar \
  -- npx -y github:Propyte-Luis/propyte-mejoras-mcp

3. Проверь, что он запустился

Перезапусти клиент и запроси список инструментов. Ты должен увидеть инструменты доски (mejoras_list_tasks, mejoras_get_task, mejoras_create_task, mejoras_update_task).

Если хочешь проверить вручную, без клиента:

export MCP_MEJORAS_TOKEN=...
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y github:Propyte-Luis/propyte-mejoras-mcp

Конфигурация

MCP_MEJORAS_URL меняется только для указания на локальный Hub (http://localhost:3001/api/mcp/mejoras).

Без MCP_MEJORAS_TOKEN мост не запускается и завершается с кодом 1, сообщая, какой переменной не хватает. Это сделано намеренно: мост, запустившийся без токена, оставил бы клиенту сервер, который на всё отвечает «не авторизовано», а это читается как «Hub упал» — и заставляет смотреть не туда.

⚠️ MCP_MEJORAS_TOKEN не является ни MCP_BLOG_TOKEN, ни MCP_API_TOKEN. Это три разных секрета для трёх разных шлюзов.

Что можно делать с инструментами

Два правила, которые устанавливает сервер, а не этот мост:

• resumen_humano должен объяснять, что изменилось, тому, кто не видит код. Шаблонное резюме отклоняется с примерами того, что действительно подходит.

• estado = 'desplegada' требует доказательства. Зелёный бейдж без доказательства — именно то, для предотвращения чего существует панель.

Безопасность

• Секрет передаётся в заголовке, а не в пути. Шлюз принимает обе формы — путь существует, потому что Cowork не может отправлять заголовки, — но путь остаётся в логах доступа сервера, и локальному процессу незачем платить эту цену. Есть тест, который это проверяет.

• В stdout выводятся только сообщения JSON-RPC. Всё остальное идёт в stderr; любую другую вещь в stdout клиент читает как протокол и закрывает соединение.

• Это общий токен, ротируемый на /mejoras/conectar. Это не учётные данные базы данных, и ни один инструмент этого шлюза не пишет в CRM.

Разработка

npm test    # 13 tests, cero dependencias

Тесты запускаются против фальшивого MCP-шлюза на localhost, и два из них проверяют бинарник как процесс — не модуль, — потому что сломанный shebang или забытый console.log не ловит ни один юнит-тест, а симптом у клиента — «сервер не запускается», без дополнительной информации.

Что они проверяют: что tools/list проходит целиком, без выдумывания или обрезания инструментов мостом; что токен не появляется в URL; что уведомление не порождает ответ; что сообщение, разбитое между двумя кусками stdin, не повреждается; что ответ SSE разворачивается с игнорированием keepalive-пингов; и что 401 или 500 доходят до клиента как ошибка с причиной, а не тишина.