operon-mcp

MCP server for Operon — manage tasks, ask the user clarifying questions, wire dependencies, and attach files to your project board directly from Claude Code (or any other MCP client).

What you can do from your IDE

After connecting, your AI agent gets these tools:

| Tool | What it does | |------|--------------| | list_tasks | List every task on the project board, including dependencies. | | get_task | Read one task in full — description, comments, attachments, deps. | | pick_task | Claim a task, move it to in_progress, set yourself as assignee. | | comment_task | Drop a progress note on a task. | | complete_task | Move a task to review with a short "done" summary. | | create_task | Add a new task to the board. | | move_task | Change a task's status (backlog/todo/in_progress/review/rework/done). | | list_rework_tasks | List tasks bounced back from review — handle these first. | | attach_file | Attach a local file from disk to a task. | | download_attachment | Pull an image/file off a task; images render inline. | | add_dependency | Mark task A as blocked by task B. Cycles are rejected. | | remove_dependency | Detach a previously-set dependency. | | ask_question | Ask the user a question on a task. They see it in the mini-app and the board, plus a Telegram nudge. | | list_questions | See every question on a task — open and answered. | | list_open_questions | See every unanswered question across the project. | | get_project_context | Read the project's documentation/context docs. | | list_pickable_tasks | List tasks ready to be picked up right now (0.6). | | next_pickable_task | Return the ONE recommended next task (0.6). | | enable_autopilot | One-call switch: kicks off the recommended answer-cron (2 min) + solver-cron (10 min) /loop pair on the current session. Say «включи автопилот» and the assistant fires both loops via the Skill tool automatically (0.7.2). |

Install

Add this to your client's MCP config (e.g. ~/.claude/.mcp.json for Claude Code):

{
  "mcpServers": {
    "operon": {
      "command": "npx",
      "args": ["-y", "operon-mcp"],
      "env": {
        "OPERON_TOKEN": "your-api-token",
        "OPERON_PROJECT": "your-project-uuid"
      }
    }
  }
}

Restart your client (or /mcp restart operon in Claude Code) and the tools above show up.

How to get a token and project id

1. Sign in at operon.gaming-goods.ru.
2. Open your project → Settings.
3. Generate API token — copy it once, it isn't shown again.
4. The project UUID is visible on the same page (or in the URL when you're on the board: /project/<uuid>/board).

Environment variables

| Variable | Required | Default | What it is | |----------|----------|---------|------------| | OPERON_TOKEN | yes | — | API token issued in project settings. | | OPERON_PROJECT | yes | — | Project UUID. | | OPERON_URL | no | https://operon.gaming-goods.ru | Override only if you self-host or need a custom endpoint. |

For backwards compatibility, the legacy NEDIMA_TOKEN / NEDIMA_PROJECT / NEDIMA_URL names are also accepted, so old .mcp.json configs keep working.

License

MIT — see LICENSE.