---
title: Claude Code | FLORA API
description: Install FLORA MCP in Claude Code with one command.
---

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

## Install

Terminal window

```
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 |

Terminal window

```
# 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

Terminal window

```
# 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

Terminal window

```
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](/mcp/authentication/index.md) — what OAuth grants the connection.
- [Tools reference](/mcp/tools/index.md) — every tool FLORA MCP exposes.
- [Recipes](/mcp/recipes/discover-and-run/index.md) — concrete workflows to try.