Claude Code

One command. The OAuth flow runs the first time you invoke a tool.

Install

claude mcp add --transport http flora https://agents.flora.ai/mcp

That’s it. Inside any Claude Code session, run /mcp — flora should appear in the list. Ask Claude to do anything FLORA-related and the OAuth browser tab opens.

Scopes

Claude Code stores MCP configs at three scopes. Pick the one that fits.

| Scope | Where | Use when | | --- | --- | --- | | local (default) | ~/.claude.json, current project only | Personal use on this project | | user | ~/.claude.json, all your projects | You want FLORA everywhere you work | | project | .mcp.json in the repo, checked into git | Your team shares FLORA across this codebase |

# Make FLORA available across all your projects
claude mcp add --transport http --scope user flora https://agents.flora.ai/mcp

# Share with the team via the repo's .mcp.json
claude mcp add --transport http --scope project flora https://agents.flora.ai/mcp

Verify

# Inside a Claude Code session
/mcp

You should see flora listed. If status is pending, trigger the OAuth flow by asking Claude to call a tool: “List my FLORA Techniques.”

Project-scoped install (.mcp.json)

After running with --scope project, your repo will contain a .mcp.json like this:

{
  "mcpServers": {
    "flora": {
      "type": "http",
      "url": "https://agents.flora.ai/mcp"
    }
  }
}

Commit it. Teammates with Claude Code will be prompted to approve the server the first time they open the repo, then they hit the same OAuth flow you did.

Remove

claude mcp remove flora

This deletes the local config and token. To also revoke the server-side authorization, go to FLORA → Settings → Connected apps and revoke FLORA MCP — Claude Code.

Common pitfalls

All flags (--transport, --scope, --header) must come before the server name. claude mcp add flora --transport http https://... will fail.

• /mcp shows failed — usually a stale token. Run claude mcp remove flora && claude mcp add --transport http flora https://agents.flora.ai/mcp to re-authenticate.
• OAuth browser doesn’t open — your shell may be sandboxed. Open the URL Claude Code prints and complete the flow manually.
• Tools not appearing — the FLORA MCP server exposes two tools (execute, search_docs), namespaced as flora:execute and flora:search_docs. Use /mcp to list them or ask: “What FLORA tools do you have?”

Next

• Authentication details — what OAuth grants the connection.
• Tools reference — every tool FLORA MCP exposes.
• Recipes — concrete workflows to try.