Claude Desktop + FAOS Integration

Connect Claude Desktop to FAOS agents and workflows in under 10 minutes.

What You'll Get

Once connected, Claude Desktop can:

Invoke specialist agents (PM, Developer, Architect, Analyst, SM) for domain expertise
Run multi-step workflows (PRD creation, code review, sprint planning)
Query project context (sprint status, stories, architecture decisions)
Track activities and get assigned tasks
Query knowledge graphs and business metrics

Quick Start (3 Steps)

Prerequisites

Claude Desktop installed
FAOS account with API access
Python 3.10+ with pipx (recommended)

Step 1: Install FAOS MCP Server

# Using pipx (recommended - isolated environment)
pipx install faos-mcp

# Or using pip
pip install faos-mcp

Verify installation:

faos-mcp --version
# Expected: faos-mcp 1.x.x

Step 2: Configure MCP

Edit your Claude Desktop MCP configuration file:

OS	Config File Location
macOS	`~/.config/claude/mcp.json`
Windows	`%APPDATA%\claude\mcp.json`
Linux	`~/.config/claude/mcp.json`

Add the FAOS server configuration:

{
  "servers": {
    "faos": {
      "command": "faos-mcp",
      "env": {
        "FAOS_API_URL": "https://api.faosx.ai",
        "FAOS_API_TOKEN": "your-token-here"
      }
    }
  }
}

Getting Your Token

Step 3: Restart Claude Desktop

Quit Claude Desktop completely (from the menu bar on macOS) and reopen it.

Verify Installation

Ask Claude:

"What FAOS tools do you have available?"

Claude should list all 17 FAOS tools including faos_invoke_agent and faos_run_workflow.

Your First Agent Invocation

Try this prompt:

"Use the FAOS PM agent to help me create an outline for a mobile app PRD"

Claude will invoke the PM specialist agent and provide structured product guidance.

Your First Workflow

Start a workflow:

"Run the FAOS create-prd workflow for a task management app"

Claude will initiate the multi-step PRD creation workflow and guide you through it.

Next Steps

Detailed Installation Guide - Troubleshooting and advanced setup
Authentication Setup - Token management, SSO, enterprise auth
Tool Reference - All 17 MCP tools with examples
Use Case Walkthroughs - Step-by-step guides for common tasks
Troubleshooting - Common issues and solutions
Advanced Topics - Enterprise setup, self-hosted, custom tools

Architecture Overview

┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
│  Claude Desktop │────▶│  FAOS MCP    │────▶│   FAOS API      │
│                 │     │  Server      │     │   (Backend)     │
└─────────────────┘     └──────────────┘     └────────┬────────┘
                                                      │
                        ┌─────────────────────────────┼─────────────────────────────┐
                        │                             │                             │
                        ▼                             ▼                             ▼
                ┌───────────────┐           ┌─────────────────┐           ┌─────────────────┐
                │   Specialist  │           │    Workflow     │           │   Knowledge     │
                │    Agents     │           │    Engine       │           │    Graph        │
                │ (PM, Dev...)  │           │  (Temporal)     │           │  (FalkorDB)     │
                └───────────────┘           └─────────────────┘           └─────────────────┘

Data Flow:

Claude Desktop sends tool calls via MCP protocol
FAOS MCP Server translates to API requests
FAOS Backend processes requests (agents, workflows, queries)
Results stream back to Claude Desktop

Support

Documentation Issues: GitHub Issues
Enterprise Support: support@faosx.ai
Community: FAOS Discord

What You'll Get​

Quick Start (3 Steps)​

Prerequisites​

Step 1: Install FAOS MCP Server​

Step 2: Configure MCP​

Step 3: Restart Claude Desktop​

Verify Installation​

Your First Agent Invocation​

Your First Workflow​

Next Steps​

Architecture Overview​

Support​