Docs / Settings

AI assistants (MCP)

Let Claude, Cursor or another assistant work in Suru Me.

Suru Me has an MCP server, so assistants such as Claude Code, Claude Desktop and Cursor can work in it for you. They can search and create tasks, plan epics, sort Unsorted, move work between areas and folders, log time, read your inbox and change settings. The assistant acts as you and can never do more than your YouTrack account allows.

Suru Me adds no AI of its own. Nothing here is on until you set it up.

Set it upLink to this section

For Claude Code, run:

claude mcp add --transport http suru-me https://surume.letmecome.in/mcp \
  --header "Authorization: Bearer suru_…"

Assistants that read a JSON config take:

{
  "mcpServers": {
    "suru-me": {
      "type": "http",
      "url": "https://surume.letmecome.in/mcp",
      "headers": { "Authorization": "Bearer suru_…" }
    }
  }
}

If you signed in through YouTrackLink to this section

An MCP key needs a connection made with a permanent token, because a YouTrack sign-in expires. If you signed in through YouTrack, the section shows the set-up with two headers instead: your own permanent token, and your YouTrack address.

{
  "Authorization": "Bearer <your YouTrack permanent token>",
  "X-YouTrack-Url": "https://yourteam.youtrack.cloud"
}

Make the token in YouTrack: your avatar, Profile, Account Security, Tokens.

Keep the key safeLink to this section

Treat a key like a password. It works until you revoke the YouTrack token it was made from, so revoke that token in YouTrack to switch the key off. A key also stops working if Suru Me changes its own secret; make a new one then.

What it can doLink to this section

About seventy tools cover what the app does:

• Read: projects, dashboards, issues with their history, links and files, an epic's or an area's whole tree, My work, the Inbox, what changed since you last looked, time reports, sprints and saved views.
• Write: create epics and tasks (with a type), edit and bulk-edit them, comment, tag, link, attach files, watch, log time, plan sprints, capture lines and mark Inbox entries done.
• Organise: move tasks between epics, make an issue an epic, move epics between areas and folders, add, style and delete areas and folders, and edit a project's values and tags.
• Settings: your YouTrack profile settings, Suru Me's own synced ones, and the default states.

When an assistant changes something, any Suru Me window open on the same YouTrack refreshes what's on screen half a second after the change is done, and once more two seconds later, when YouTrack's search has caught up. You see the change without reloading.

Assistants and agentsLink to this section

An assistant you connect here and an agent are different things. An assistant works when you ask it to, in your chat, as you. An agent is a name like @claude that your workspace has set up to receive comments; whatever listens at its webhook does the work and answers in comments.

The two meet in comments. When an assistant comments with add_comment and mentions an agent, Suru Me sends that comment to the agent, just as the comment box does, provided you may use that agent. Assigning an issue to an agent's own account with update_issue or update_issues starts the agent the same way. Each of these answers agentsCalled: the agents it reached, and an error on any it didn't. See Agents handing work to each other.

An agent can connect to this MCP server too, with an MCP key made from its own YouTrack account. It then reads and changes work as that account, and its comments can hand work on to other agents. Setting agents up isn't something an assistant can do; admins do that in Settings.

Ready-made promptsLink to this section

Your assistant may offer these by name:

• Plan an epic: break an epic into tasks, and create them once you agree.
• Triage Unsorted: sort a project's Unsorted issues into epics and areas.
• My standup: what you did, what's next, and what's overdue or waiting on you.
• Project review: progress per area and epic, work that's gone quiet, and next steps.