DocsGetting started
Connect your YouTrack
Sign in with YouTrack, a permanent token or a client ID.
Suru Me has no account of its own. Connecting to YouTrack is how you sign in. Open the app, type your YouTrack address (like yourteam.youtrack.cloud) and press Connect.
Ways to sign inLink to this section
- With just the address, Suru Me sends you to YouTrack to approve access. This works when your YouTrack admin has allowed automatic sign-in for apps (YouTrack 2026.2 and later).
- If your admin registered Suru Me and gave you a client ID, open My admin gave me a client ID and paste it in.
- If neither works, open Use a permanent token instead. A token works on every YouTrack and needs no admin.
Making a permanent tokenLink to this section
- In YouTrack, click your avatar, then Profile.
- Open Account Security, then Tokens, and create a new token.
- Copy it straight away, since YouTrack shows it only once, and paste it into the Token box in Suru Me.
A token acts as you until you revoke it in YouTrack. Keep it like a password. Connecting with a token is also what lets you create an MCP key for an AI assistant.
Sign-in linksLink to this section
The connect page reads its fields from the address, so a link can sign someone in with one click:
/connect?instance=acmestarts signing in toacme.youtrack.cloudstraight away./connect?instance=acme&clientId=…does the same with a client ID./connect?instance=acme#token=perm-…signs in with a permanent token.
If something goes wrongLink to this section
The connect page says what happened. The usual causes are a mistyped address, a token YouTrack doesn't accept, or a sign-in that took too long or was opened in another tab (try again). If YouTrack refuses the sign-in, your admin may need to allow Suru Me first, or you can use a token.
DisconnectingLink to this section
Open the user menu at the bottom of the sidebar and choose Disconnect. It signs you out and empties the pages and data this browser kept for offline use. It doesn't revoke a permanent token; do that in YouTrack if you want the token gone.