Back to Aira

MCP Integration

MCP Integration

Aira exposes its product management capabilities through the Model Context Protocol (MCP). This lets Claude Code, Claude Desktop, ChatGPT, and any other MCP-compatible client call Aira as a tool server.

What MCP gives you

Instead of switching to the Aira web UI, you can do PM work directly from your AI assistant:

  • Create and manage projects
  • Add sources and trigger analysis
  • Generate insights, PRDs, features, and sprint plans
  • Assign and update tasks
  • Chat with Aira for status queries and reports
  • Monitor project health via pulse actions

The web UI and MCP use the same backend logic. Behavior is consistent across both interfaces.

Three deployment modes

ModeURLAuthBest for
Managed Remotemcp.aira.proOAuth (browser login)Most users — no setup required
Self-hosted Remotemcp.your-domain.comOAuth (your instance)Enterprise, private data, compliance
Locallocalhost:8000API keyDevelopment, debugging, no internet

When to use each

  • Managed Remote — You have an Aira account at app.aira.pro and want to connect Claude or ChatGPT. Start here.
  • Self-hosted Remote — You're deploying Aira in your own cloud for security or compliance reasons. Your MCP clients connect to your instance.
  • Local — You're developing against aira-agent locally and want to test MCP integration. Everything runs on your machine.

Structured-first usage

When calling Aira via MCP, prefer typed tools over the chat fallback:

  • Use update_task, assign_task, start_sprint, generate_pulse_actions for state changes
  • Use list_tasks, list_features, get_current_sprint for queries
  • Fall back to chat_with_aira only when a typed tool doesn't exist for your intent

Guides

Documentation