@sota-io/mcp

sota.io 向けMCPサーバー — AIエージェント経由でWebアプリをデプロイします。

2つのトランスポート

v1.4.0 以降、このパッケージは 2つのトランスポート を提供します。

• sota-mcp（stdio、デフォルト）— Claude Code、Cursor、Windsurf、およびローカルプロセスを起動する任意のMCPクライアント向け。環境変数で SOTA_API_KEY を渡します。

• sota-mcp-http（Streamable HTTP）— mcp.sota.io を動作させるリモートエンドポイントを自己ホストする場合に使用します（Claude Desktop および Claude.ai web で使用）。SUPABASE_JWT_SECRET、DATABASE_URL などを読み取ります。ほとんどのユーザーはこれを必要としません。自分でホストしたい場合に mcp.sota.io で実行されているのと同じコードです。

ほとんどのユーザーは stdio トランスポートを使用します。

Related MCP server: AppsAI MCP Server

Claude Desktop / Claude.ai web 向けワンクリックインストール

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 に次のように依頼します: "Deploy my app to 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

リンク

• Webサイト

• ドキュメント

• ダッシュボード

• Issues