# Canopy account

> Canopy account is a freemium MCP server for security. Run every Canopy identity API operation as a tool, signed in as you or on an API key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://canopy-io.com/docs/mcp
- **Repository:** https://github.com/canopy-identity/canopy
- **MCP Registry name:** com.canopy-io/account
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

Every operation in Canopy's public API becomes one tool, named by its operation id, so an assistant can do whatever your credential allows and nothing beyond it. Start with the whoami tool, which reports the principal, Account, Application and Environment behind the connection.

Most clients sign in through the browser: you approve the client for one Environment, choose read only or read and change, and can untick individual capabilities. A read-only client is offered only reading tools. Tools that delete, replace or rotate something are marked destructive so the client can ask first, and updates carry the record's version as If-Match and fail with 409 if it changed. Clients that cannot open a browser, such as CI jobs, send an X-API-Key instead, and the key's scopes decide what works.

Approved clients are listed under Connected Apps in the Developer Console and can be revoked there; one unused for 30 days has to sign in again. A separate unauthenticated docs server at canopy-io.com/mcp answers questions about the console and admin workspace.

## Features

- **One tool per operation:** Each public API operation is a tool named by its operation id.
- **Browser or key sign-in:** OAuth-style approval per Environment, or an X-API-Key for scripts.
- **Capability limits:** Approve read only, or untick capabilities the client should not use.
- **Safety annotations:** Read tools and destructive tools are marked so clients can ask first.
- **Version checks:** Updates use If-Match and bulk creates accept an Idempotency-Key.
- **Connected app list:** Review and revoke approved clients in the Developer Console.

## Good for

- Ask an assistant to list or inspect roles and applications in an Environment
- Create API keys or administrator roles within a limited capability set
- Run access evaluations and previews from a chat
- Automate account settings from CI with a scoped key
- Check what a credential is allowed to do before acting

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http account https://auth.canopy-io.com/mcp/v1
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://auth.canopy-io.com/mcp/v1
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "account": {
      "url": "https://auth.canopy-io.com/mcp/v1"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "account": {
      "type": "http",
      "url": "https://auth.canopy-io.com/mcp/v1"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "account": {
      "serverUrl": "https://auth.canopy-io.com/mcp/v1"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "account": {
      "type": "http",
      "url": "https://auth.canopy-io.com/mcp/v1"
    }
  }
}
```

## FAQ

### How do I connect Claude Code?

Run claude mcp add --transport http canopy https://auth.canopy-io.com/mcp/v1, then sign in from /mcp.

### Can I make it read only?

Yes. Approve the client as Read only, or use an API key whose scopes only read.

### What if my client cannot open a browser?

Send an Environment or account API key in the X-API-Key header; account keys also need X-Canopy-Environment.

### Is there a free plan for Canopy?

The pricing page lists a Free plan with 10,000 monthly active users, plus Starter, Pro and Enterprise.

### Is Canopy account free?

Canopy account has a free plan, with paid plans for more usage or features.

### How do I add Canopy account to Claude Code?

Run this command in your terminal: claude mcp add --transport http account https://auth.canopy-io.com/mcp/v1

### What are the best alternatives to Canopy account?

The closest alternatives to Canopy account are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/canopy-account
