Airfocus MCP Server

Connect your AI assistant to Airfocus - the modular product management platform. This MCP server enables AI tools to read, search, and manage items across your Airfocus workspaces.

Why Use This?

For Product Managers:

• Ask your AI to summarize items across workspaces
• Quickly search for features, feedback, or opportunities using natural language
• Create and update items without leaving your AI chat
• Get instant answers about your product backlog

For Teams:

• Automate routine product management tasks
• Generate reports and insights from your Airfocus data
• Streamline workflows between AI tools and Airfocus

Use Cases

Use Case	Example Prompt
Backlog overview	"List all items in the Solutions workspace"
Search & filter	"Find all items created this month with status 'In Development'"
Quick capture	"Create a new feedback item titled 'Mobile app crashes on login'"
Status updates	"Update item X to status 'Done'"
Cross-workspace search	"Search for anything related to 'authentication' across all workspaces"

Available Tools

Tool	Description
list_workspaces	List all accessible Airfocus workspaces
get_workspace	Get details of a specific workspace
get_item	Get a single item by ID
list_items	List items in a workspace with pagination
search_items	Advanced search with filters, sorting, and pagination
create_item	Create a new item (title, description, status)
update_item	Update an existing item
delete_item	Delete an item

Search Capabilities

The search_items tool supports:

• Text search: Search in item title and description
• Status filter: Filter by status name
• Date filters: createdAfter, createdBefore, updatedAfter, updatedBefore
• Sorting: Sort by createdAt, updatedAt, or title
• Pagination: limit (1-100) and offset parameters

Setup

1. Get Your Airfocus API Key

1. Open Airfocus and go to Account Settings > API keys
2. Click Add API key
3. Select required scopes and copy the key

2. Get Your Apify API Token

1. Sign up at Apify
2. Go to Settings > Integrations > API tokens
3. Copy your API token

3. Configure Your AI Tool

---

Claude Desktop

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop requires the mcp-remote bridge for HTTP-based MCP servers. Add this configuration:

{
  "mcpServers": {
    "airfocus": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://filip-cicvarek--airfocus-mcp-server.apify.actor/mcp",
        "--header",
        "Authorization: Bearer YOUR_APIFY_API_TOKEN",
        "--header",
        "x-airfocus-api-key: YOUR_AIRFOCUS_API_KEY"
      ]
    }
  }
}

After saving, restart Claude Desktop for changes to take effect.

---

Cursor

Config file location:

• macOS/Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

Create the file if it doesn't exist and add:

{
  "mcpServers": {
    "airfocus": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://filip-cicvarek--airfocus-mcp-server.apify.actor/mcp",
        "--header",
        "Authorization: Bearer YOUR_APIFY_API_TOKEN",
        "--header",
        "x-airfocus-api-key: YOUR_AIRFOCUS_API_KEY"
      ]
    }
  }
}

Restart Cursor after saving the configuration.

---

Windsurf

Config file location:

• macOS/Linux: ~/.codeium/windsurf/mcp_config.json
• Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Windsurf supports HTTP transport natively, so no bridge is required:

{
  "mcpServers": {
    "airfocus": {
      "serverUrl": "https://filip-cicvarek--airfocus-mcp-server.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_API_TOKEN",
        "x-airfocus-api-key": "YOUR_AIRFOCUS_API_KEY"
      }
    }
  }
}

---

VS Code (GitHub Copilot)

Option 1: Workspace settings (.vscode/mcp.json in your project):

{
  "servers": {
    "airfocus": {
      "type": "http",
      "url": "https://filip-cicvarek--airfocus-mcp-server.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_API_TOKEN",
        "x-airfocus-api-key": "YOUR_AIRFOCUS_API_KEY"
      }
    }
  }
}

Option 2: User settings (via Command Palette > "Preferences: Open User Settings (JSON)"):

{
  "mcp": {
    "servers": {
      "airfocus": {
        "type": "http",
        "url": "https://filip-cicvarek--airfocus-mcp-server.apify.actor/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_APIFY_API_TOKEN",
          "x-airfocus-api-key": "YOUR_AIRFOCUS_API_KEY"
        }
      }
    }
  }
}

Note: MCP support in VS Code requires GitHub Copilot with MCP enabled.

---

Other MCP-Compatible Tools

For any tool that supports the Model Context Protocol, use these connection details:

Setting	Value
URL	https://filip-cicvarek--airfocus-mcp-server.apify.actor/mcp
Transport	Streamable HTTP
Headers	Authorization: Bearer YOUR_APIFY_TOKEN
	x-airfocus-api-key: YOUR_AIRFOCUS_KEY

If your tool doesn't support HTTP transport directly, use the mcp-remote npm package as a bridge (see Claude Desktop/Cursor examples above).

---