Skip to main content

Configure MCP

Connect an AI agent (Claude, Cursor, etc.) to your Fyso workspace using the MCP server.

The @fyso/claude-plugin package installs skills, hooks, and the MCP connection in one command:

bunx @fyso/claude-plugin install

Authentication uses OAuth — a browser window opens on first use, no API key needed. See Claude Code Plugin for full details.

Option 2: Claude Desktop (manual config)​

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "fyso": {
      "command": "npx",
      "args": ["-y", "@fyso/mcp-server"],
      "env": {
        "FYSO_API_KEY": "your-api-key",
        "FYSO_API_URL": "https://api.fyso.dev/api",
        "FYSO_TOOLS": "core"
      }
    }
  }
}

Option 3: Smithery​

Install directly from Smithery.ai:

npx @smithery/cli install @fyso/mcp-server --client claude

Option 4: Anthropic Connectors Directory​

Find Fyso in the Anthropic MCP Connectors Directory and install with one click.

Environment Variables (manual config only)​

These apply when configuring the MCP server manually (Option 2). The Claude Code plugin handles authentication via OAuth and does not require these variables.

VariableRequiredDescription
FYSO_API_KEYYesYour Fyso API key
FYSO_API_URLYeshttps://api.fyso.dev/api
FYSO_TOOLSNoTool profile: core (default), advanced, all

Typical Workflow​

list_tenants()
→ select_tenant({ tenantSlug: "mi-empresa" })
→ list_entities()
→ query_records({ entityName: "clientes", limit: 10 })

Compatible Clients​

  • Claude Code (via @fyso/claude-plugin)
  • Claude Desktop
  • Cursor
  • Codex
  • Gemini
  • Any MCP-compatible client