# Стендиум — MCP-сервер

> ⚠️ **Есть удалённая версия без установки.** Теперь Стендиум отдаёт MCP-сервер по
> HTTP — ничего локально ставить не нужно, обновления приходят сами. Подключение —
> одной командой из [профиля → Для разработчиков](https://stendium.ru/profile/settings?tab=developers).
> Этот локальный (stdio) пакет оставлен как запасной и получает только критические
> багфиксы; новые возможности выходят в HTTP-версии.

Публикация рабочих инструментов на [Стендиум](https://stendium.ru) — витрину-портфолио, где инструменты находят и пробуют, — из любого агента с поддержкой MCP: Claude Code, Codex, Cursor, Gemini CLI.

Агент сам изучает проект, собирает карточку (что это, под какие задачи, что принимает и отдаёт) и показывает её вам на подтверждение. Публикация уходит на витрину только после явного «да».

## Инструменты

| Инструмент | Что делает |
|---|---|
| `check_access` | Проверяет, задан ли токен и отвечает ли API. Вызывается первым, если не уверены в настройке |
| `publish_tool` | Публикует или обновляет карточку инструмента. Требует `confirmed=true` — то есть согласия автора |

Главное поле карточки — `jobs`: 2–5 конкретных задач, которые инструмент решает, человеческими словами. Именно по ним инструмент находят люди и агенты.

## Установка

Нужен **Node.js 18+**. Устанавливать вручную ничего не нужно — агент сам скачает пакет через `npx` при первом запуске.

1. Создайте персональный токен: [stendium.ru](https://stendium.ru) → Аватар → Профиль и настройки → Для разработчиков.
2. Подключите сервер к своему агенту.

**Claude Code** — одна команда:

```bash
claude mcp add stendium -s user -e STENDIUM_TOKEN=ваш-токен -- npx -y stendium-mcp@latest
```

**Codex, Cursor, Gemini CLI** — в их конфиге MCP пропишите stdio-сервер: команда `npx`, аргументы `-y stendium-mcp@latest`, переменная окружения `STENDIUM_TOKEN`. Пример (TOML/JSON зависит от агента):

```json
{
  "mcpServers": {
    "stendium": {
      "command": "npx",
      "args": ["-y", "stendium-mcp@latest"],
      "env": { "STENDIUM_TOKEN": "ваш-токен" }
    }
  }
}
```

`@latest` в команде — намеренно: без него `npx` берёт версию из кеша и обновления сервера не доходят.

После подключения перезапустите агента.

Переменные окружения:

- `STENDIUM_TOKEN` — персональный токен, обязателен для публикации;
- `STENDIUM_BASE_URL` — адрес API, по умолчанию `https://stendium.ru` (нужен только для локальной разработки).

Токен читается **только из окружения**: в аргументах инструментов его нет, в логи он не попадает.

## Разработка

Из клона репозитория:

```bash
git clone https://github.com/stendium/stendium-mcp.git
cd stendium-mcp
npm install
node smoke.mjs        # поднимает сервер по stdio и запрашивает список инструментов, ничего не публикует
node smoke-gate.mjs   # проверяет, что publish_tool отказывается публиковать без confirmed=true
```

## Связанное

- [stendium/stendium-plugin](https://github.com/stendium/stendium-plugin) — плагин Claude Code с теми же возможностями через скиллы `/stendium-publish` и `/stendium-story`.

## Лицензия

MIT