Integration Guides

Azure DevOps Integration

Connect AJAIA to your Azure DevOps organization to create and manage work items.

Prerequisites

• An Azure DevOps account with access to at least one organization
• Project Collection Administrator or Project Administrator permissions
• Ability to create Personal Access Tokens

Step 1: Create a Personal Access Token (PAT)

1. Go to Azure DevOps
   Navigate to dev.azure.com and sign in to your account.
2. Open User Settings
   Click your profile picture in the top right corner, then select "Personal access tokens".
3. Create New Token
   Click "New Token" and configure the following:
   • Name: AJAIA Integration
   • Organization: Select your organization (or "All accessible organizations")
   • Expiration: Choose an appropriate timeframe (we recommend 90 days)
4. Set Permissions
   Select "Custom defined" and enable the required scopes (see table below).
5. Copy Your Token
   Click "Create" and immediately copy the token. You won't be able to see it again!

Required PAT Permissions

Step 2: Connect in AJAIA

1. Open Settings
   Log in to AJAIA and navigate to Settings > Integrations.
2. Add Azure DevOps Connection
   Click "Add Connection" and select "Azure DevOps".
3. Enter Your Details
   
   • Organization URL: https://dev.azure.com/your-org
   • Personal Access Token: Paste your PAT
4. Test Connection
   Click "Test Connection" to verify everything is working.
5. Save
   Click "Save" to store your connection securely.

Troubleshooting

• "Unauthorized" error: Your PAT may have expired or lacks required permissions. Create a new token with the correct scopes.
• "Organization not found": Verify the organization URL is correct, including the exact capitalization.
• "Project not accessible": Ensure you have at least Contributor access to the project.

Jira Integration

Connect AJAIA to Jira Cloud or Jira Server to sync and manage issues.

Prerequisites

• A Jira Cloud or Jira Server/Data Center account
• Project Administrator permissions or higher
• Ability to create API tokens (Cloud) or application links (Server)

Jira Cloud Setup

1. Create an API Token
   Go to Atlassian Account Settings and click "Create API token".
2. Name Your Token
   Enter a label like "AJAIA Integration" and click "Create".
3. Copy the Token
   Copy the generated token immediately - you won't see it again.
4. Connect in AJAIA
   In AJAIA Settings > Integrations, add a Jira connection with:
   • Jira URL: https://your-domain.atlassian.net
   • Email: Your Atlassian account email
   • API Token: The token you just created

Jira Server/Data Center Setup

1. Create Application Link
   In Jira Administration, go to Applications > Application Links.
2. Configure OAuth
   Add AJAIA as an application link with OAuth authentication.
3. Connect in AJAIA
   Enter your Jira Server URL and complete the OAuth flow.

Required Jira Permissions

MCP Integration

Connect AJAIA to AI assistants using the Model Context Protocol for seamless IDE integration.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to securely access external tools and data sources. With AJAIA's MCP server, you can:

• Query and search work items directly from your AI assistant
• Create new tasks, stories, and bugs without leaving your IDE
• Update work item status as you complete work
• Generate AI breakdowns through natural conversation

Supported AI Clients

• Claude Desktop: Native MCP support
• VS Code + Continue: Via MCP extension
• Cursor: Native MCP support
• Other MCP-compatible clients

Setup for Claude Desktop

Install via npm: ajaia-mcp-server

1. Generate Your AJAIA API Key
   In AJAIA, go to Settings > MCP API Keys and click "Generate New Key". Give it a descriptive name like "Claude Desktop - Work Laptop". Copy the key immediately - you won't see it again!
2. Open Claude Desktop Config
   Find the Claude Desktop configuration file:
   Windows: %APPDATA%\Claude\claude_desktop_config.json
   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Add AJAIA MCP Server
   Add the following to your config file (replace ajaia_xxxx... with your actual API key):
   {
     "mcpServers": {
       "ajaia": {
         "command": "npx",
         "args": ["-y", "ajaia-mcp-server"],
         "env": {
           "AJAIA_API_KEY": "ajaia_xxxxxxxxxx..."
         }
       }
     }
   }
4. Restart Claude Desktop
   Completely close and reopen Claude Desktop to load the new configuration.
5. Verify Connection
   Ask Claude: "What AJAIA tools do you have access to?" to confirm the integration is working. You should see 8 tools available.

Setup for Cursor

1. Generate Your AJAIA API Key
   Same as above - go to Settings > MCP API Keys and generate a key for Cursor.
2. Open Cursor Settings
   Go to Cursor Settings (Cmd/Ctrl + ,) > Features > MCP Servers.
3. Add New MCP Server
   Click "Add MCP Server" and configure:
   • Name: AJAIA
   • Command: npx
   • Arguments: -y ajaia-mcp-server
4. Set Environment Variable
   Add the environment variable AJAIA_API_KEY with your API key.
5. Enable and Test
   Toggle the server on and test by asking the AI about your work items.

Setup for VS Code with Continue Extension

1. Install Continue Extension
   Install the Continue extension from the VS Code marketplace.
2. Configure MCP
   Open Continue settings and add AJAIA as an MCP server with the same configuration as above.

Available MCP Tools

Example Conversations

Environment Variables