AI 클라이언트가 에이전트, 도구, 모델을 관리하고 호출별 비용을 추적할 수 있도록 단일화된 거버넌스 MCP 엔드포인트를 제공합니다.
다른 이름 decocms/studio, deco-cli, decocms
- 스타
- 418
- Tools
- —
- 다운로드, 30일
- 85,291
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- MIT
deco Studio MCP란?
deco Studio은(는) MCP server입니다. AI 클라이언트가 에이전트, 도구, 모델을 관리하고 호출별 비용을 추적할 수 있도록 단일화된 거버넌스 MCP 엔드포인트를 제공합니다.
프로젝트 README에서 생성된 요약
deco Studio MCP server 정보
Studio는 조직의 AI 배포를 위한 중앙 집중식 제어 평면을 제공합니다. 호출별 비용을 추적하면서 에이전트, 도구 및 모델을 관리하는 단일 거버넌스 MCP 엔드포인트 역할을 합니다. 조직은 이를 사용하여 컨텍스트와 정책을 패키징하여 Cursor, Claude Desktop 또는 VS Code와 같은 클라이언트에서 호출 가능한 게시형 에이전트로 만들 수 있습니다.
사용자는 암호화된 vault를 통해 GitHub, Slack 또는 Postgres와 같은 프라이빗 시스템을 연결할 수 있어, 실제 자격 증명을 공유하지 않고도 팀 간에 MCP 기능을 공유할 수 있습니다. 이 플랫폼은 교체 가능한 모델 레이어를 지원하여 OpenRouter 또는 Anthropic, OpenAI, Google과 같은 직접 제공업체로의 연결을 가능하게 합니다. PostgreSQL 및 NATS와 함께 Docker Compose를 사용하여 로컬에 배포하거나, 원격 팀 액세스를 위해 클라우드 서비스를 통해 사용할 수 있습니다.
관리자는 지연 시간, 오류 및 토큰을 추적하는 관측성 대시보드를 통해 감독 기능을 유지합니다. 시스템은 SSO, 역할 기반 액세스 제어 및 감사 로그를 포함한 엔터프라이즈급 관리 기능을 제공하여 회사 전체에서 안전하고 책임 있는 AI 사용을 보장합니다.
활용 사례
- 1내부 도구의 안전한 공유개발자는 기본 자격 증명을 노출하지 않고도 에이전트에 프라이빗 데이터베이스에 대한 액세스 권한을 부여할 수 있습니다.
- 2AI 운영 비용 모니터링관리자는 다양한 모델과 에이전트에 정확히 얼마의 비용이 지출되고 있는지 추적할 수 있습니다.
- 3에이전트 설정 표준화팀은 조직 전체에서 사용할 수 있도록 사전 정의된 지침과 도구를 갖춘 특정 에이전트를 생성할 수 있습니다.
- 4멀티 모델 라우팅 관리엔지니어는 단일 인터페이스를 통해 다양한 작업에 대해 서로 다른 AI 제공업체 간을 전환할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
deco Studio MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 deco Studio MCP 설치
$ claude mcp add studio -- npx -y deco-cliCursor에 deco Studio MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"studio": {
"command": "npx",
"args": [
"-y",
"deco-cli"
]
}
}
}VS Code에 deco Studio MCP 설치
.vscode/mcp.json
{
"servers": {
"studio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"deco-cli"
]
}
}
}VS Code CLI에 deco Studio MCP 설치
$ code --add-mcp '{"name":"studio","type":"stdio","command":"npx","args":["-y","deco-cli"]}'Claude Desktop에 deco Studio MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"studio": {
"command": "npx",
"args": [
"-y",
"deco-cli"
]
}
}
}Codex에 deco Studio MCP 설치
$ codex mcp add studio -- npx -y deco-cliCodex config.toml에 deco Studio MCP 설치
~/.codex/config.toml
[mcp_servers.studio] command = "npx" args = ["-y", "deco-cli"]
Gemini CLI에 deco Studio MCP 설치
$ gemini mcp add -s user studio npx -- -y deco-cliGemini settings.json에 deco Studio MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"studio": {
"command": "npx",
"args": [
"-y",
"deco-cli"
]
}
}
}자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기TL;DR: Your team needs a secure internal vibecoding platform. You just found it. Configure agents with team context. Connect private MCPs once — share capabilities, not credentials. Keep the model layer interchangeable. Roll out across the organization with SSO, RBAC, audit logs, and cost controls — all through one MCP endpoint. Local-first. Self-host or use the cloud.
What is deco Studio?
Studio packages the infrastructure behind an internal AI rollout: model routing, MCP authentication, agent configuration, SSO, RBAC, audit logs, and usage accounting. Your teams get chat. You keep control.
Under the hood it's one control plane for your AI agents — one MCP endpoint for all your agents, tools, and models. Agents package context, tools, and policy into something you publish to the organization. Connections give them governed access to your systems — GitHub, Slack, Postgres, Sentry, anything that speaks MCP — with tokens stored in an encrypted vault. Models stay interchangeable: OpenRouter or direct providers, chosen per agent and per tool.
Start with one team. Standardize approved models, tools, and context. Expand across the organization without copying secrets or rebuilding the platform. Install locally and it stays private; sync to the cloud for remote access, team roles, and shared billing.
┌─────────────────────────────────────────────────────────────────┐
│ Clients │
│ Cursor · Claude · VS Code · Custom Agents │
└───────────────────────────┬─────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ DECO STUDIO │
│ Agents · Connections · Models · Vault · Observability │
└───────────────────────────┬─────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Tools & MCP Servers │
│ GitHub · Slack · Postgres · OpenRouter · Your APIs │
└─────────────────────────────────────────────────────────────────┘
Quick Start
Install Docker with Compose, then run from source:
git clone https://github.com/decocms/studio.git
cd studio
docker compose up --build --watch
Open http://localhost:4000. Compose starts PostgreSQL, NATS, object storage, migrations, and the hot-reloading API and web app. See CONTRIBUTING.md for contributor setup and worktrees.
What you get
Agents
Package context, tools, and policy into an agent. Define instructions, add skills and files, grant approved MCP access, choose a model policy, then publish the agent to the organization. Each agent is its own MCP endpoint — callable from Cursor, Claude Desktop, your own code, or another agent. Agents compose, and every action is tracked with cost attribution.
Connections
Connect private systems once, securely. Register MCP servers at the organization level through a web UI with one-click OAuth — no JSON configs. Tokens live in the encrypted vault, and you grant tool-level access by organization, role, or agent. Share MCP capabilities — not credentials.
As tool surfaces grow, Studio exposes Virtual MCPs — one endpoint, different strategies for which tools to surface:
- Full-context: expose everything (simple, deterministic, good for small toolsets)
- Smart selection: narrow the toolset before execution
- Code execution: load tools on demand in a sandbox
Models
Keep the AI layer interchangeable. Use OpenRouter or connect Anthropic, OpenAI, Google, or any compatible provider directly — the best model for each agent and tool, behind one router. For coding work, engineers can link their own Claude Code or Codex session and use the subscription already authenticated on their machine.
Projects
Projects bring agents and connections together around a goal. The project's UI adapts to what's inside — add a content agent and a CMS connection, the sidebar shows content management; add an analytics agent and a database, it shows dashboards and queries. The UI you see is the UI that's relevant for operating that project.
Observability
Account for every model and tool call. Trace the user, agent, model, tools, latency, errors, tokens, and cost for every thread. Break usage down by agent, connection, organization, or teammate — one dashboard.
From your desktop to your org
| Local | Docker Compose on your laptop, including PostgreSQL, NATS, and object storage. |
| Cloud | Log in to studio.decocms.com. Control local projects from any browser. |
| Team | Invite people. SSO and role-based access. Shared connections. Cost attribution. |
| Enterprise | Self-hosted. Organization isolation, tool-scoped API keys, audit logs. Your infra, your rules. |
Core Capabilities
| Capability | What it does |
|---|---|
| Agents | Package context, tools, and policy into publishable agents with cost attribution |
| Connections | Route MCP traffic through one governed endpoint with auth, proxy, and encrypted token vault |
| Models | Interchangeable AI layer — OpenRouter or direct providers, model policy per agent |
| Projects | Organize agents and connections around goals with an adaptive UI |
| Virtual MCPs | Compose and expose governed toolsets as new MCP endpoints |
| Observability | Traces, costs, errors, and latency per user, agent, and connection — one dashboard |
| Access Control | SSO + RBAC via Better Auth — OAuth 2.1 and tool-scoped API keys per workspace/project |
| Multi-tenancy | Organization/project isolation for config, credentials, policies, and audit logs |
| Bindings | Capability contracts so tools target interfaces, not specific implementations |
| Store | Discover and install agents, tools, and templates |
Define Tools
Type-safe, audited, observable, callable via MCP.
import { z } from "zod";
import { defineTool } from "~/core/define-tool";
export const CONNECTION_CREATE = defineTool({
name: "CONNECTION_CREATE",
description: "Create a new MCP connection",
inputSchema: z.object({
name: z.string(),
connection: z.object({
type: z.enum(["HTTP", "SSE", "WebSocket"]),
url: z.string().url(),
token: z.string().optional(),
}),
}),
outputSchema: z.object({
id: z.string(),
scope: z.enum(["workspace", "project"]),
}),
handler: async (input, ctx) => {
await ctx.access.check();
const conn = await ctx.storage.connections.create({
projectId: ctx.project?.id ?? null,
...input,
createdById: ctx.auth.user!.id,
});
return { id: conn.id, scope: conn.projectId ? "project" : "workspace" };
},
});
Every tool call gets input/output validation, access control, audit logging, and OpenTelemetry traces automatically.
Documentation
Studio documentation lives in docs-tanstack, alongside the Storefront documentation. Update public product guides and architecture there. Workspace READMEs and engineering plans stay here with the implementation.
Project Structure
Applications
| Workspace | Purpose |
|---|---|
apps/api |
Hono API, authentication, tools, storage, migrations, and the deco CLI |
apps/web |
Vite and React 19 administration interface |
Packages
| Workspace | Purpose |
|---|---|
packages/bindings |
Runtime-validated MCP capability contracts |
packages/create-deco |
npm create deco project scaffolding CLI |
packages/e2e |
Black-box Playwright suite for Studio |
packages/harness-runner |
In-sandbox coding-agent harness process |
packages/mcp-utils |
MCP proxy, gateway, aggregation, and sandbox primitives |
packages/runtime |
Runtime helpers for MCP servers, OAuth, tools, and triggers |
packages/sandbox |
Agent sandbox lifecycle, daemon, dispatch, and proxy implementation |
packages/sandbox-controller |
Sandbox provider bundled for a remote host such as the control plane |
packages/shared |
Private isomorphic contracts, SDK utilities, and async primitives |
packages/typegen |
Typed client generator for Studio Virtual MCPs |
packages/ui |
Internal React design system |
Development
bun install # Install dependencies
bun run dev # Docker Compose Watch: dependencies, migrations, API + web
bun test # Run tests
bun run check # Type check
bun run lint # Lint
bun run fmt # Format
App-specific commands
bun run --cwd=apps/web dev # Vite dev server (port 4000)
bun run --cwd=apps/api dev:server # Hono server with hot reload
bun run --cwd=apps/api migrate # Run database migrations
For parallel worktrees, Compose lifecycle commands, and frontend-only work, see CONTRIBUTING.md.
Deploy Anywhere
# Docker Compose: released Studio + PostgreSQL + NATS + object storage
docker compose -f selfhost/examples/docker-compose/compose.yaml up -d
# Kubernetes (Helm)
helm install deco-studio oci://ghcr.io/decocms/chart-deco-studio --version <version> -n deco-studio --create-namespace
Run Studio with Docker Compose or Kubernetes on your own infrastructure.
What you need to run it
| Tier | Footprint |
|---|---|
| Laptop | Docker with Compose; the development stack includes its dependencies. |
| Docker | Published Studio image with configured PostgreSQL, NATS, and object storage. |
| Production (Helm) | PostgreSQL you bring, plus NATS for streaming and cross-pod coordination, ClickHouse + OTel Collector (traces and analytics), and the sandbox operator (isolated agent environments on Kubernetes). Your identity provider, your model keys, your storage. |
Production topology
graph TB
clients["MCP clients — Cursor · Claude · VS Code · your code"]
clients -->|"one MCP endpoint · SSO · RBAC · audit"| api
subgraph k8s ["Kubernetes (Helm)"]
api["Studio API + Admin UI"]
api --> sandbox["Agent sandboxes<br/>(sandbox-operator)"]
api <-->|"streams and broadcasts"| nats["NATS"]
api -->|"traces · costs"| otel["OTel Collector"]
nats <-->|"streams and broadcasts"| worker["Workers<br/>DBOS runs"]
otel --> ch[("ClickHouse")]
end
pg[("PostgreSQL")]
api --> pg
worker <-->|"DBOS queues and journal"| pg
subgraph upstream ["Models & tools"]
models["Anthropic · OpenAI<br/>OpenRouter · Ollama"]
mcps["GitHub · Slack · Postgres<br/>your MCP servers"]
end
api -->|"model routing · vaulted credentials"| upstream
Every box is optional except Studio and PostgreSQL — start small, turn on the rest as the rollout grows.
Tech Stack
| Layer | Tech |
|---|---|
| Runtime | Bun / Node |
| Language | TypeScript + Zod |
| Framework | Hono (API) + Vite + React 19 |
| Database | Kysely → PostgreSQL |
| Auth | Better Auth (OAuth 2.1 + API keys) |
| Observability | OpenTelemetry |
| UI | React 19 + Tailwind v4 + shadcn |
| Protocol | Model Context Protocol (MCP) |
Roadmap
- Agent marketplace — discover, hire, and compose agents
- Declarative planning engine
- Cost analytics and spend caps
- Remote access from any browser
- Live tracing debugger
- Workflow orchestration with guardrails
License
MIT — see LICENSE.md.
Questions? builders@decocms.com
Contributing
bun run fmt # Format
bun run lint # Lint
bun test # Test
See AGENTS.md for coding guidelines, CONTRIBUTING.md for the contribution workflow, and TESTING.md for the testing rules.
Good first steps: open an issue, pick one labeled good first issue, or ask in Discord.
Contributors
Studio is built in the open. Thanks to everyone who has shipped a commit.
Maintainers — see MAINTAINERS.txt:
@guitavano · @viktormarinho · @mcandeia · @pedrofrxncx · @JonasJesus42 · @aka-sacci-ccr · @vibegui · @tlgimenes · @vibe-dex · @nicacioliveira
deco Studio MCP 질문
deco Studio MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add studio -- npx -y deco-cli를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
deco Studio MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
deco Studio를 로컬에서 어떻게 실행하나요?
저장소를 클론한 후 Docker Compose로 시작하고 localhost:4000을 열면 됩니다. Compose를 통해 PostgreSQL, NATS, object storage, migrations, API 및 웹 앱이 함께 실행됩니다.
Studio는 연결된 도구의 자격 증명을 어떻게 저장하나요?
MCP server 토큰은 조직 수준의 암호화된 vault에 저장되며, 조직, 역할 또는 에이전트별로 액세스 권한이 부여됩니다.
다른 AI 모델 제공업체를 사용할 수 있나요?
네, Studio는 에이전트와 도구별로 선택된 OpenRouter 또는 Anthropic, OpenAI, Google과 같은 직접 제공업체를 통해 모델을 라우팅합니다.
에이전트 사용량에 대해 무엇을 추적할 수 있나요?
모든 모델 및 도구 호출은 사용자, 에이전트, 모델, 지연 시간, 오류, 토큰 및 비용을 추적하며, 에이전트, 연결, 조직 또는 팀원별로 상세히 확인할 수 있습니다.
Studio는 SSO와 역할 기반 액세스를 지원하나요?
네, OAuth 2.1 기반의 Better Auth를 통한 SSO 및 RBAC, 도구 범위 API 키를 제공하며, 셀프 호스팅 배포 시 조직 격리 및 감사 로그 기능을 지원합니다.