sota

@sota-io/mcp

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

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 ウェブ版で使用）。SUPABASE_JWT_SECRET、DATABASE_URL などを読み込みます。ほとんどのユーザーには必要ありません。独自のホストを運用する場合に備え、mcp.sota.io で稼働するコードと同じものです。

ほとんどのユーザーには、stdio トランスポートが適しています。

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	アプリをデプロイします	project_id、directory?
get-logs	ビルド／実行時のログを取得します	project_id、deployment_id?
set-env	環境変数を設定します	project_id、key、value
get-env	環境変数の一覧を取得します	project_id
rollback	以前のデプロイにロールバックします	project_id
get-status	デプロイのステータスを取得します	project_id
list-projects	すべてのプロジェクトを一覧表示します	(なし)
create-project	新しいプロジェクトを作成します	name
delete-project	プロジェクトを完全に削除します	project_id
add-domain	プロジェクトにカスタムドメインを追加します	project_id、domain
list-domains	カスタムドメインを一覧表示します	project_id
get-domain	ドメインの詳細と DNS のステータスを取得します	project_id、domain_id
remove-domain	カスタムドメインを削除します	project_id、domain_id

deploy

アプリケーションを sota.io にデプロイします。指定したディレクトリの tar.gz アーカイブを作成し、アップロードします。

パラメーター	型	必須	説明
project_id	string	はい	デプロイ先のプロジェクト ID
directory	string	いいえ	デプロイするディレクトリ（デフォルトは現在の作業ディレクトリ）

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

get-logs

デプロイメントのビルドログとランタイムログを取得します。deployment_id が指定されていない場合は、最新のデプロイメントのログを返します。

Parameter	Type	Required	Description
project_id	string	Yes	ログを取得するプロジェクトの ID
deployment_id	string	No	特定のデプロイメント ID（デフォルトは最新のデプロイメント）

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

set-env

プロジェクトの環境変数を設定します。

Parameter	Type	Required	Description
project_id	string	Yes	プロジェクト ID
key	string	Yes	環境変数名（例：DATABASE_URL）
value	string	Yes	環境変数の値

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

get-env

プロジェクトの環境変数を一覧表示します。

Parameter	Type	Required	Description
project_id	string	Yes	プロジェクト ID

"Show all environment variables for my project"

rollback

プロジェクトを前回のデプロイメントにロールバックします。再ビルドせずにコンテナイメージを切り替えます。

Parameter	Type	Required	Description
project_id	string	Yes	ロールバックするプロジェクトの ID

"Roll back my app to the previous version"

get-status

URLや最近のデプロイメント履歴など、プロジェクトの現在のデプロイメントステータスを取得します。

Parameter	Type	Required	Description
project_id	string	Yes	ステータスを確認するプロジェクトの ID

"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 になります。

Parameter	Type	Required	Description
name	string	Yes	新しいプロジェクトの名前

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

delete-project

sota.io からプロジェクトとそのすべてのデプロイメントを削除します。この操作は取り消せません。

Parameter	Type	Required	Description
project_id	string	Yes	削除するプロジェクトの ID

"Delete my sota.io project abc123"

add-domain

プロジェクトにカスタムドメインを追加します。ドメインの向き先を設定するための DNS 手順を返します。

Parameter	Type	Required	Description
project_id	string	Yes	プロジェクト ID
domain	string	Yes	ドメイン名（例：「example.com」または「app.example.com」）

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

list-domains

プロジェクトのすべてのカスタムドメインを一覧表示します。

Parameter	Type	Required	Description
project_id	string	Yes	プロジェクト ID

"Show all custom domains for my project"

get-domain

DNS の検証ステータスや SSL の状態など、ドメインの詳細を取得します。

Parameter	Type	Required	Description
project_id	string	Yes	プロジェクト ID
domain_id	string	Yes	ドメイン ID

"Check the DNS status of my custom domain"

remove-domain

プロジェクトからカスタムドメインを削除します。

Parameter	Type	Required	Description
project_id	string	Yes	プロジェクト ID
domain_id	string	Yes	削除するドメインの ID

"Remove the custom domain from my project"

環境変数

Variable	Required	Default	Description
SOTA_API_KEY	Yes	—	sota_ プレフィックス付きの API キー。sota.io/dashboard/settings で作成できます
SOTA_API_URL	No	https://api.sota.io	API のベース URL

トラブルシューティング

「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

リンク

• ウェブサイト
• ドキュメント
• ダッシュボード
• 課題