Skip to Content
Integrations

Integrations

AgentLoop integrates with external services to enhance your development workflow. This page covers Jira, GitHub, and MCP (Model Context Protocol) integrations.

Jira Integration

Bidirectional synchronization with Jira Cloud keeps tasks aligned across both platforms.

Features

FeatureDescription
OAuth 2.0 and Basic AuthFlexible authentication options
Automatic task syncingTasks stay in sync between AgentLoop and Jira
AI-powered DAG planningGenerate task dependencies from Jira issue links
Sprint and board managementSync with Jira sprints and boards

Configuration

Add Jira settings to your config file:

[jira] siteUrl = "https://yourcompany.atlassian.net" project = "PROJ" boardId = "123" # Basic Auth (simpler) email = "user@example.com" apiToken = "your_api_token"

Authentication Methods

Basic Auth is simpler to set up:

  1. Generate an API token in Jira (Settings → Security → API tokens)
  2. Add credentials to your AgentLoop config:
    [jira] email = "user@example.com" apiToken = "your_api_token"
  3. Restart the daemon (or quit and reopen the desktop app) so the new credentials are loaded

Syncing Tasks

Once Jira is configured, you can ask AgentLoop in chat to sync:

Sync with Jira.

Pull in any new Jira tasks for this project.

The AI-powered DAG sync analyzes Jira issue links and infers dependencies between tasks automatically.

Finding Your Board ID

The board ID is needed for accurate syncing. Find it in your Jira board URL:

https://yourcompany.atlassian.net/jira/software/projects/PROJ/boards/123 ^^^ Board ID

GitHub Integration

GitHub integration enables automated PR creation and branch management by the release agent.

Configuration

[github] enabled = true token = "ghp_your_token_here" # Or use environment variable

Or use an environment variable:

export GITHUB_PERSONAL_ACCESS_TOKEN="ghp_your_token_here"

Required Token Scopes

The GitHub Personal Access Token needs:

  • repo — Full control of private repositories
  • workflow — Update GitHub Action workflows (if your project uses them)

What GitHub Integration Enables

When GitHub is configured, agents can:

  • Create branches for tasks
  • Commit and push changes
  • Open pull requests as the release agent
  • Update PR descriptions with task context

MCP Integration

Model Context Protocol (MCP) lets AgentLoop integrate with external tools and services.

What is MCP?

MCP is an open protocol for extending AI agents with external capabilities. AgentLoop can use MCP servers to:

  • Access external APIs
  • Query databases
  • Interact with third-party services
  • Use custom tools you’ve built

Bundled MCP Server

AgentLoop ships its own MCP server so other agentic tools (like Claude Code, Cursor, or VS Code extensions) can talk to AgentLoop. This means you can drive AgentLoop tasks from another tool that speaks MCP.

External MCP Servers

You can also configure external MCP servers for your agents to use. The configuration lives in your AgentLoop config — see the Configuration panel in the desktop app.

Plugin System

AgentLoop’s plugin system supports:

  • Custom agent templates — Define new agents with specific behaviors using markdown templates
  • Layered configuration — Build-time, runtime, and per-project settings
  • MCP integration — Connect to external MCP servers

Configuration Reference

Jira Settings

OptionDescription
siteUrlJira site URL (e.g., https://company.atlassian.net)
projectJira project key (e.g., PROJ)
boardIdBoard ID for accurate syncing
emailEmail for Basic Auth
apiTokenAPI token for Basic Auth
clientIdOAuth client ID
clientSecretOAuth client secret

GitHub Settings

OptionDefaultEnv VariableDescription
enabledtrueEnable GitHub integration
tokenGITHUB_PERSONAL_ACCESS_TOKENGitHub PAT

Example Configuration

Complete integration setup:

# GitHub [github] enabled = true # Jira [jira] siteUrl = "https://mycompany.atlassian.net" project = "DEV" boardId = "42" email = "developer@mycompany.com" apiToken = "your-jira-api-token"

Never commit API tokens or secrets to version control. Use environment variables for sensitive credentials.

Last updated on
AgentLoop — Multi-agent loops you can see and control