@sota-io/mcp

sota.io용 MCP 서버 — AI 에이전트를 통해 웹 앱을 배포하세요.

두 가지 전송 방식

v1.4.0부터 이 패키지는 두 가지 전송 방식을 제공합니다:

• sota-mcp (stdio, 기본값) — Claude Code, Cursor, Windsurf 및 로컬 프로세스를 실행하는 모든 MCP 클라이언트용. SOTA_API_KEY를 환경 변수로 전달하세요.

• sota-mcp-http (Streamable HTTP) — mcp.sota.io를 구동하는 원격 엔드포인트를 자체 호스팅하기 위한 것(Claude Desktop 및 Claude.ai 웹에서 사용). SUPABASE_JWT_SECRET, DATABASE_URL 등을 읽습니다. 대부분의 사용자에게는 필요하지 않습니다. 자체 호스팅을 원할 경우 mcp.sota.io에서 실행되는 동일한 코드입니다.

대부분의 사용자는 stdio 전송 방식을 원합니다.

Related MCP server: AppsAI MCP Server

Claude Desktop / Claude.ai 웹용 원클릭 설치

Claude Desktop 또는 Claude.ai(Pro / Max / Team / Enterprise 요금제)를 사용하는 경우, 가장 쉬운 설치는 이 npm 패키지가 아닌 mcp.sota.io에서 호스팅되는 원격 엔드포인트입니다. 여기를 클릭하세요:

Claude에 추가 →

OAuth가 인증을 처리합니다. 신규 사용자는 create_account 도구를 통해 Claude 내에서 완전히 가입할 수 있습니다. 브라우저 탭 전환이 필요 없습니다.

https://sota.io/docs/integrations/claude를 참조하세요.

빠른 시작 (stdio — Claude Code, Cursor, Windsurf, …)

1. sota.io/dashboard/settings에서 API 키를 받으세요.

2. IDE를 구성하세요.

3. AI에게 *"내 앱을 sota.io에 배포해줘"*라고 요청하세요.

설치

설치 필요 없음 — npx로 직접 실행:

npx -y @sota-io/mcp

또는 전역 설치:

npm install -g @sota-io/mcp
sota-mcp

구성

Claude Code

CLI 방식:

claude mcp add sota -- npx -y @sota-io/mcp

그런 다음 셸 환경에서 API 키를 설정하세요:

export SOTA_API_KEY=sota_your_api_key_here

수동 JSON (.claude/settings.json):

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json을 편집하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Cursor

프로젝트 루트에 .cursor/mcp.json을 생성하세요:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json을 편집하세요:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

도구

deploy

애플리케이션을 sota.io에 배포합니다. 지정된 디렉터리의 tar.gz 아카이브를 생성하여 업로드합니다.

"Deploy my app in the current directory to sota.io"

get-logs

배포의 빌드 및 런타임 로그를 가져옵니다. deployment_id가 제공되지 않으면 최신 배포의 로그를 반환합니다.

"Show me the build logs for my sota.io project"

set-env

프로젝트의 환경 변수를 설정합니다.

"Set DATABASE_URL on my project to postgres://localhost/mydb"

get-env

프로젝트의 환경 변수를 나열합니다.

"Show all environment variables for my project"

rollback

프로젝트를 이전 배포로 롤백합니다. 컨테이너 이미지를 다시 빌드하지 않고 교체합니다.

"Roll back my app to the previous version"

get-status

프로젝트의 현재 배포 상태(URL 및 최근 배포 기록 포함)를 가져옵니다.

"What's the status of my sota.io deployment?"

list-projects

sota.io 계정의 모든 프로젝트를 나열합니다.

매개변수가 필요하지 않습니다.

"List my sota.io projects"

create-project

sota.io에 새 프로젝트를 생성합니다. 프로젝트 슬러그는 이름에서 자동 생성되며(소문자, 하이픈, 최대 63자) 서브도메인({slug}.sota.io)으로 사용됩니다. 예를 들어 "My API"는 my-api.sota.io가 됩니다.

"Create a new sota.io project called my-api"

delete-project

sota.io에서 프로젝트와 모든 배포를 삭제합니다. 이 작업은 영구적입니다.

"Delete my sota.io project abc123"

add-domain

프로젝트에 사용자 정의 도메인을 추가합니다. 도메인을 가리키기 위한 DNS 지침을 반환합니다.

"Add example.com as a custom domain to my project"

list-domains

프로젝트의 모든 사용자 정의 도메인을 나열합니다.

"Show all custom domains for my project"

get-domain

DNS 확인 상태 및 SSL 상태를 포함한 도메인 세부 정보를 가져옵니다.

"Check the DNS status of my custom domain"

remove-domain

프로젝트에서 사용자 정의 도메인을 제거합니다.

"Remove the custom domain from my project"

환경 변수

문제 해결

"npx: command not found"

문제: IDE가 nvm/fnm이 로드된 셸 PATH를 상속하지 않습니다.

해결 방법: npx의 절대 경로를 사용하세요. 다음 명령어로 찾을 수 있습니다:

which npx
# Example output: /Users/you/.nvm/versions/node/v22.0.0/bin/npx

그런 다음 MCP 구성을 업데이트하여 절대 경로를 사용하세요:

{
  "mcpServers": {
    "sota": {
      "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

"SOTA_API_KEY environment variable is required"

문제: MCP 구성에 API 키가 설정되지 않았습니다.

해결 방법: MCP 서버 구성에 env 블록을 추가하세요. 셸 환경 변수는 MCP 서버에 자동으로 전달되지 않습니다 — 구성에 env 블록이 필요합니다:

{
  "env": {
    "SOTA_API_KEY": "sota_your_api_key_here"
  }
}

연결 거부 또는 시간 초과 오류

문제: 네트워크 문제 또는 잘못된 API URL.

해결 방법: 인터넷 연결을 확인하세요. 사용자 정의 API URL을 사용하는 경우 SOTA_API_URL이 올바르게 설정되었는지 확인하세요. 기본값은 https://api.sota.io입니다.

라이선스

MIT

링크

• 웹사이트

• 문서

• 대시보드

• 이슈