MCP Server Setup Guide
ISO Mate’s MCP (Model Context Protocol) server lets AI assistants and IDE tools manage your project data directly. This guide walks you through setup and usage.
Step 1: Create an API Token
- Navigate to User Profile > API Tokens.
- Click Create Token.
- Give the token a descriptive name (e.g., “IDE MCP Token”).
- Select the scopes your tool needs:
- issues.view: List and get issues and comments
- issues.create: Create new issues
- issues.update: Update issues and add comments
- issues.delete: Delete issues
- Click Save and copy the token. It will not be shown again.
Step 2: Configure Your MCP Client
Add the ISO Mate MCP server to your client’s configuration. The exact format depends on your tool, but you will need:
- Server URL: Your ISO Mate API endpoint
- API Token: The token you created in Step 1
Available Tools
Once connected, the following tools are available:
- list_issues: Query issues with filters (status, priority, type, sprint, assignee, project key, search)
- get_issue: Get a single issue by UUID or project key (e.g., TSK-42)
- create_issue: Create a new issue (requires summary and type)
- update_issue: Update fields on an existing issue
- delete_issue: Delete an issue
- add_issue_comment: Add a comment to an issue
- list_issue_comments: List all comments on an issue
Using Project Keys
You can reference issues by their project key instead of UUID. For example, pass BUG-7 to get_issue to retrieve that bug directly. Use the project_key filter in list_issues to find all issues with a given prefix (e.g., all BUG-* issues).
Security Notes
- Each token is scoped to a single account. Data from other accounts is never accessible.
- Grant only the scopes your tool needs (principle of least privilege).
- Revoke tokens immediately if they are compromised.