Get a personal access token for MCdesk

Your organization connects MCdesk to MCintelligentplus with an endpoint, and every member authenticates with their own personal access token (PAT). The token identifies you to MCdesk, so the tools act as you — never as a coworker or a shared service account.

Before you start

• Ask your MCintelligentplus organization owner to publish MCdesk to your workspaces. It appears under User Settings → Apps once it is available.
• Sign in to MCdesk in a browser with the account you use for tickets.

Create the token in MCdesk

1. Sign in to your MCdesk deployment (for example https://mcdesk.example.com).
2. Open your avatar menu and choose Profile (个人资料).
3. Switch to the Personal Token (私人令牌) tab.
4. Click Create token (or the equivalent button in your MCdesk version).
5. Name the token after where it will be used, for example MCintelligentplus, so it is easy to recognize and revoke later.
6. Confirm the creation. MCdesk shows the token once — copy it immediately and keep it in a safe place.

MCdesk may show expiry or permission options. When they exist, choose the narrowest set that still lets you read and update the tickets you need, and a rotation period that matches your security policy.

Connect MCdesk in MCintelligentplus

1. Open User Settings → Apps and choose MCdesk.
2. Paste the token into the Personal access token (PAT) field.
3. Click Test. The test signs in to MCdesk with the token and lists the tools it can reach; it does not create or change anything.
4. When the test passes, click Connect.

The token is stored encrypted and sent to MCdesk as the X-API-Key header on every call. It follows you into every workspace where the organization enabled MCdesk.

Rotate or revoke a token

• Rotate: create a new token in MCdesk, open Apps → MCdesk in MCintelligentplus, click Replace, paste the new token, test and save. Then revoke the old token in MCdesk.
• Revoke (lost device, suspected leak): revoke the token in MCdesk first. MCintelligentplus calls start failing with an authentication error and the Apps card offers Reconnect; create a replacement token and paste it there.

Troubleshooting

Never share a personal access token: each member needs their own, and MCdesk audits actions per token.