ChatATP Studio MCP Server

Studio Django /dapi/ API를 MCP 도구로 변환하는 원격 FastMCP 서버입니다.

이 프로젝트가 대상으로 하는 공개 URL:

https://mcp.chat-atp.com/studio/mcp

클라이언트(Cursor, Claude, Copilot, ChatATP 에이전트)는 Streamable HTTP를 통해 이 서버에 연결합니다. 모든 도구 호출은 호출자의 Authorization 헤더와 함께 기존 백엔드로 프록시됩니다.

제공되는 것

작업 중심 도구 모음:

• 에이전트(list_agents, create_agent, preview_agent, ...)

• 지식 베이스 + 에이전트 첨부 파일

• MCP 서버 정의 + 연결

• HTTP API 도구 + execute_http_api_connection

• LLM 공급자 + API 키 설정

• 메시징 플랫폼

• Teams / whoami

삭제 및 연결 해제는 confirm=true를 필요로 합니다.

Related MCP server: mcp_sdk_eyra_accelerator_v15

로컬 실행

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

export STUDIO_API_URL=https://chatatp-agent-builder-backend.onrender.com
export STUDIO_TOKEN=chatatp_sk_...   # optional fallback
uvicorn app:app --host 0.0.0.0 --port 8000

확인:

curl http://localhost:8000/health

MCP 엔드포인트:

http://localhost:8000/studio/mcp

인증

1. 권장: MCP 클라이언트가
   Authorization: Bearer <studio jwt 또는 chatatp_sk_...>
   헤더를 보내면 서버는 해당 헤더를 /dapi/로 전달합니다.

2. 대체: 환경 변수의 STUDIO_TOKEN / STUDIO_API_KEY(단일 테넌트/내부).

고객 토큰을 이미지에 넣지 마세요.

mcp.chat-atp.com/studio/mcp에 배포

mcp.chat-atp.com 호스트를 경로를 유지한 채 이 서비스로 지정하세요.
MCP_PATH는 기본적으로 /studio/mcp이므로, 이 서비스가 호스트 이름을 직접 처리하거나(또는 /studio/mcp를 그대로 받아야 합니다).

Docker

docker build -t chatatp-studio-mcp .
docker run --rm -p 8000:8000 \
  -e STUDIO_API_URL=https://chatatp-agent-builder-backend.onrender.com \
  -e STUDIO_TOKEN=... \
  chatatp-studio-mcp

Render

이 저장소에는 render.yaml이 포함되어 있습니다. 배포 후 Cloudflare/DNS를 지정하세요:

mcp.chat-atp.com  →  <your-render-service>.onrender.com

mcp.chat-atp.com에 이미 다른 서비스가 있고 /studio/*만 이 서버로 보내려면, 접두사를 제거하지 않고 리버스 프록시하세요:

location /studio/ {
    proxy_pass http://studio-mcp:8000;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header Authorization $http_authorization;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_buffering off;
    proxy_read_timeout 120s;
}

location /health {
    proxy_pass http://studio-mcp:8000/health;
}

Caddy:

mcp.chat-atp.com {
    reverse_proxy /studio/* localhost:8000
    reverse_proxy /health localhost:8000
}

프록시가 /studio를 제거한다면 MCP_PATH=/mcp로 설정해서 공개 URL이 제거 후에도 여전히 /studio/mcp가 되게 하세요. 둘 다 하지 마세요.

클라이언트 연결

Cursor / Claude Desktop / 모든 Streamable HTTP MCP 클라이언트:

{
  "mcpServers": {
    "chatatp-studio": {
      "url": "https://mcp.chat-atp.com/studio/mcp",
      "headers": {
        "Authorization": "Bearer chatatp_sk_..."
      }
    }
  }
}

Inspector:

npx @modelcontextprotocol/inspector
# then connect to http://localhost:8000/studio/mcp

환경 변수

참고

• Studio CLI에서 추론된 것으로 표시되는 경로(/dapi/mcp/servers/, /dapi/http-api/tools/, /dapi/llm/configs/, 에이전트 preview)는 studio_mcp/endpoints.py에 있습니다. 라우트가 404를 반환하면 해당 파일만 수정하세요.

• 문서 업로드는 아직 지원되지 않습니다(multipart). MCP 파일 인제스트를 원하면 전용 도구를 추가하세요.

• Copilot 어시스턴트 엔드포인트(/dapi/assistant/...)는 일부러 감싸지 않았으므로, 이 서버는 Copilot 내부로 재귀하지 않습니다.