Quick Start

Quick Start

Get Meta Business MCP up and running in under 60 seconds.

⏱ Under 60 seconds

Prerequisites

  • Docker & Docker Compose (version 20.10+ / Compose V2)
  • Go 1.21+ (only if building from source)

No Meta API keys required for local development — mock credentials are used by default.

Clone and Start

git clone https://github.com/metabusiness-mcp/meta-business-mcp.git
cd meta-business-mcp
docker compose up -d --build

Wait for all containers to become healthy:

docker compose ps
# All should show "healthy"

What starts:

ServicePortDescription
PostgreSQL 16:5432Primary database
Redis 7:6379Cache & rate limiter
NATS JetStream:4222Async message broker
Mock Meta API:8081Simulates Meta Cloud API
Meta Business MCP:8080 + MCP stdioMain application

Access the Dashboard

Open your browser: http://localhost:8080

On first run, the server auto-generates a random password and prints it to the terminal:

╔══════════════════════════════════════════════════════════╗
║              DASHBOARD CREDENTIALS (auto-generated)      ║
╠══════════════════════════════════════════════════════════╣
║  Username: admin                                         ║
║  Password: a1b2c3d4e5f6g7h8                             ║
╚══════════════════════════════════════════════════════════╝

Copy the password and log in.

Connect Your AI Agent

The MCP server runs on stdio. Configure your AI client:

Claude Desktop — Add to claude_desktop_config.json:

{
  "mcpServers": {
    "meta-business-mcp": {
      "command": "/path/to/meta-business-mcp",
      "args": []
    }
  }
}

Cursor — Add to your MCP settings via the IDE UI or config file.

Verify

curl http://localhost:8080/health
# OK

What’s Next?

Architecture