Managed Remote MCP

The managed remote server at mcp.aira.pro is the recommended way to connect MCP clients to Aira. No backend setup required — just your Aira account and a one-line configuration.

Prerequisites

An Aira account at app.aira.pro
At least one project created
An MCP-compatible client (Claude Code, Claude Desktop, or ChatGPT)

Step 1: Create your account and project

Go to app.aira.pro
Sign up or sign in
Create at least one project (name, description, vision)

Step 2: Configure your MCP client

Claude Code

claude mcp add --transport http aira https://mcp.aira.pro/mcp

Verify:

claude mcp list
claude mcp get aira

Claude Desktop

Add to your MCP server configuration:

Server URL: https://mcp.aira.pro/mcp
Transport: HTTP

ChatGPT

Add as an MCP server with URL:

https://mcp.aira.pro/mcp

Step 3: Authenticate

When you first use an Aira tool from your MCP client, the OAuth flow starts:

Your client connects to mcp.aira.pro/mcp
MCP OAuth discovery finds the authorization endpoints
A browser window opens to app.aira.pro for login/consent
You log in with your Aira credentials (your existing session is reused if you're already logged in)
You select/confirm the project to use
The client receives OAuth tokens and you're connected

After the first authentication, your session persists until the token expires.

Step 4: Test it

Open your MCP client and try:

List tools from aira.

List my projects.

Add a source text: "Users report that onboarding takes too long and has too many steps."

Generate features from the latest insights.

Available MCP tools

The MCP server exposes tools for the full PM workflow:

Tool category	Examples
Projects	`list_projects`, `switch_project`, `get_auth_context`
Sources	`add_source`, `list_sources`, `delete_source`
Insights	`list_insights`, `patch_insight`, `dismiss_insight`
Features	`list_features`, `generate_features`, `update_feature`
Tasks	`list_tasks`, `create_task`, `update_task`, `assign_task`, `delete_task`
Sprints	`list_sprints`, `start_sprint`, `complete_sprint`, `commit_sprint_scope`
Pulse	`generate_pulse_actions`, `dismiss_pulse_action`
Chat	`chat_with_aira` (fallback for anything without a typed tool)

Example workflow

Use Aira MCP tools to:
1) list my projects
2) pick project "Mobile App v2"
3) add a source text named "user-research" with content:
   "Users say the checkout flow is confusing. They want fewer steps and clearer progress indicators."
4) generate insights from this source
5) generate features from those insights
6) show me a summary of created insights and features

Follow-up:

Now create a sprint plan for the top 3 features and assign tasks to team members based on current capacity.

Troubleshooting

Make sure you're logged in at app.aira.pro in your browser
Verify you have at least one project membership
Check the MCP domain is exactly mcp.aira.pro (no typos)

Token expired

Re-authenticate by triggering any Aira tool call. The OAuth flow will start again.

Project not found

Run list_projects to see your available projects
Use switch_project to select the right one
Verify your project membership at app.aira.pro

`invalid_client` or `invalid_grant`

Usually means:

Wrong redirect URI registered by the client
Expired or reused authorization code
PKCE verifier mismatch

Try removing and re-adding the MCP server:

claude mcp remove aira
claude mcp add --transport http aira https://mcp.aira.pro/mcp