# deco Studio MCP server

> Gives AI clients a single governed MCP endpoint for agents, tools, models, and per-call cost tracking.

- Repository: https://github.com/decocms/studio
- Page: https://hostedmcp.org/servers/decocms/studio
- Transport: stdio
- Stars: 418
- License: MIT

## Install

### Claude Code

```sh
claude mcp add studio -- npx -y deco-cli
```

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

```json
{
  "mcpServers": {
    "studio": {
      "command": "npx",
      "args": [
        "-y",
        "deco-cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "studio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "deco-cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"studio","type":"stdio","command":"npx","args":["-y","deco-cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "studio": {
      "command": "npx",
      "args": [
        "-y",
        "deco-cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add studio -- npx -y deco-cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.studio]
command = "npx"
args = ["-y", "deco-cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user studio npx -- -y deco-cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "studio": {
      "command": "npx",
      "args": [
        "-y",
        "deco-cli"
      ]
    }
  }
}
```

## FAQ

### How do I run deco Studio locally?

Clone the repository and start it with Docker Compose, then open localhost:4000. Compose brings up PostgreSQL, NATS, object storage, migrations, and the API and web app.

### How does Studio store credentials for connected tools?

MCP server tokens are kept in an encrypted vault at the organization level, and access is granted per organization, role, or agent.

### Can I use different AI model providers?

Yes, Studio routes models through OpenRouter or direct providers such as Anthropic, OpenAI, and Google, chosen per agent and tool.

### What can I track about agent usage?

Every model and tool call is traced with user, agent, model, latency, errors, tokens, and cost, broken down by agent, connection, organization, or teammate.

### Does Studio support SSO and role-based access?

Yes, it offers SSO and RBAC via Better Auth with OAuth 2.1 and tool-scoped API keys, plus organization isolation and audit logs for self-hosted deployments.
