Simplifyd Cloud

Simplifyd Cloud MCP サーバー

Simplifyd Cloud プラットフォーム用の MCP (Model Context Protocol) サーバーです。

MCP 対応クライアントから Simplifyd Cloud リソースを管理するためのツールを提供します。stdio（ローカルクライアントがバイナリをサブプロセスとして起動）または streamable HTTP（ホスト型のマルチユーザー構成）のいずれかで利用できます。どちらも同じバイナリで動作し、MCP_TRANSPORT で選択します。

ツール

カテゴリー	ツール
認証	login（stdio のみ）、get-me
ワークスペース	list-workspaces、get-workspace、create-workspace、update-workspace、get-workspace-usage、get-workspace-transactions、get-my-role、list-workspace-members、add-workspace-member、update-member-role、remove-workspace-member、fund-workspace、get-registry、list-registry-repos、list-registry-artifacts、delete-registry-tag
レジストリ認証情報	list-registry-credentials、add-registry-credential、update-registry-credential、remove-registry-credential — プライベートレジストリ（ghcr.io、Docker Hub など）用のワークスペースのプル認証情報です。レジストリごとに、そのワークスペースの Docker イメージサービスに継承されます。サービス固有の認証情報は、update-service の registry_credentials および clear_registry_credentials アクションで設定します
プロジェクト	list-projects、get-project、create-project、update-project
環境	list-environments、get-environment、create-environment、update-environment、list-env-variables、create-env-variable、update-env-variable、delete-env-variable
サービス	list-services、get-service、create-service、update-service、delete-service、list-private-service-access、grant-private-service-access、revoke-private-service-access、list-service-variables、add-service-variable、set-service-variables、delete-service-variable、add-service-ingress、delete-service-ingress、add-tcp-proxy、delete-tcp-proxy、set-ingress-source-ranges、add-service-config、update-service-config、delete-service-config、approve-service-changeset、discard-service-changeset、add-shared-variable
デプロイ	list-deployments、get-deployment、deploy-service、redeploy-service、undeploy-service、get-deployment-logs
メトリクス	get-service-metrics、get-environment-metrics — 過去 1 時間、6 時間、または 1 日の CPU、メモリ、ディスク使用量を割り当て量に対する割合で示し、スケーリングのシグナルも表示します
トークン	list-tokens、create-token、delete-token
テンプレート	list-templates、get-template、deploy-template、get-publishable-variables
メール	list-email-domains、add-email-domain、verify-email-domain、remove-email-domain — create-service とタイプ email を指定してサービス自体を作成します
ドメイン	search-domains、quote-domain、list-domains、get-domain、register-domain（stdio のみ）、renew-domain（stdio のみ）、update-domain。購入と更新では、確認のための 2 回目の呼び出し時にのみウォレットに課金されます。ホスト型サーバーではこれらのツールを提供していません。Claude と ChatGPT のディレクトリでは支出を伴うツールが認められておらず、ユーザーは代わりにコンソールで購入や更新を行うためです。
DNS	list-dns-zones、add-dns-zone、check-dns-zone、delete-dns-zone、list-dns-records、add-dns-record、update-dns-record、delete-dns-record

各ツールにはタイトルと、明示的な readOnlyHint、destructiveHint、openWorldHint の注釈が付いており、クライアントはこれらを使って呼び出し前に確認するかどうかを判断します。分類は tools/annotations.go に定義されており、注釈なしでツールを追加するとテストが失敗します。

ディレクトリへの登録

server.json は、MCP Registry に登録するホスト型サーバーについて記述したファイルです。Lovable など、レジストリに対応したクライアントがこの情報を参照します。リリースごとに version を更新し、mcp-publisher publish で公開してください。

ビルド

go build -o cloud-mcp .

トランスポート

変数	デフォルト	意味
MCP_TRANSPORT	stdio	stdio または http
MCP_ADDR	:8080	リッスンアドレス（http のみ）
MCP_ALLOWED_ORIGINS	(なし)	ブラウザーのオリジン許可リスト（カンマ区切り、http のみ）
SIMPLIFYD_API_URL	https://api.cloud.simplifyd.com	API ベース URL
OPENAI_APPS_CHALLENGE	(なし)	OpenAI のプラグインポータルで取得するドメイン検証トークン。/.well-known/openai-apps-challenge で配信されます（http のみ）

HTTP では、MCP エンドポイントはオリジン直下と /mcp で応答し、 プローブ用にプレーンな /healthz を提供します。 セッションはステートレスであるため、レプリカにスティッキールーティングは必要ありません。

認証

認証はトランスポートごとに行われ、相互に混在することはありません。

• stdio — 単一のローカルユーザーです。トークンは SIMPLIFYD_API_TOKEN または ~/.simplifyd/config.json から取得され、login ツールで対話的に設定できます。
• http — 複数の呼び出し元に対応します。各リクエストには個別の Authorization: Bearer <token> を含める必要があり、そのトークンはその呼び出しにのみ使用されます。 何も永続化されず、呼び出し元の間で認証情報が共有されることもありません。また、login は登録されません。 登録すると、ある呼び出し元の認証情報がサーバーのディスクに書き込まれ、他のすべてのユーザーにも適用されてしまうためです。

stdio

オプション 1 — 環境変数（CI に推奨）：

export SIMPLIFYD_API_TOKEN="your-jwt-token"

オプション 2 — 対話型ログイン： login ツールを使って、メールアドレスとパスワードで認証します。トークンは ~/.simplifyd/config.json に保存され、その後の実行時に自動的に再利用されます。

Claude Code の設定

MCP 設定（.claude/settings.json または ~/.claude/settings.json）に追加します。

{
  "mcpServers": {
    "simplifyd-cloud": {
      "command": "/path/to/cloud/mcp/cloud-mcp",
      "env": {
        "SIMPLIFYD_API_TOKEN": "your-jwt-token"
      }
    }
  }
}

または、対話的に認証する場合（SIMPLIFYD_API_TOKEN を省略し、先に login を実行します）：

{
  "mcpServers": {
    "simplifyd-cloud": {
      "command": "/path/to/cloud/mcp/cloud-mcp"
    }
  }
}

http

サーバーを実行します。

MCP_TRANSPORT=http MCP_ADDR=:8080 ./cloud-mcp

クライアントを接続し、API トークンをヘッダーとして渡します。

{
  "mcpServers": {
    "simplifyd-cloud": {
      "type": "http",
      "url": "https://mcp.simplifyd.com",
      "headers": {
        "Authorization": "Bearer your-jwt-token"
      }
    }
  }
}

create-token ツールまたはダッシュボードでトークンを作成します。

セキュリティ

Origin ヘッダーを含むリクエストは、そのオリジンが MCP_ALLOWED_ORIGINS に登録されていない限り拒否されます。これにより、 ユーザーのブラウザー上のページからホストされたサーバーを操作できてしまう DNS リバインディング攻撃を防ぎます。 ブラウザー以外のクライアントは Origin を送信しないため、影響を受けません。

通常のリソース応答には、変数の値、パスワード、接続 URL、認証情報の塊、設定ファイルの内容は含まれません。説明に認証情報を明示的に開示すると記載されているツールは、設計上、機密データを返します。必要な場合にのみ使用し、出力をログやチケットにコピーしないでください。

デプロイログでは一般的な認証情報のパターンがフィルタリングされますが、アプリケーションが予期しない形式でシークレットを出力することがあります。ログを共有する前に、出力を確認してください。