SaaSus API MCP Server 設定ガイド
概要
SaaSus API MCP Serverは、Model Context Protocol (MCP) サーバーとして動作し、SaaSus APIをClaude DesktopやCursorなどのMCP互換クライアントから利用できるようにします。
前提条件
- Node.js(v16以上必須、v20以上推奨)
- npm(Nodeに含まれています)
インストール手順
1. リポジトリのクローン
以下のコマンドでプロジェクトをクローンしてください。
git clone https://github.com/saasus-platform/saasus-api-mcp-server.git
cd saasus-api-mcp-server
2. 依存関係のインストール
プロジェクトのルートディレクトリ で以下のコマンドを実行してください。
npm install
3. 利用可能なツールの確認
生成されたツールの説明とパラメータを確認するには、以下のコマンドを実行してください。
node index.js tools
実行例:
Available Tools:
Workspace: saasus-auth-api-schema
Collection: get-basic-configurations.js
get_basic_configurations
Description: Get basic configurations including domain name and CNAME records.
Parameters:
[...]
Claude Desktop での設定
1. ローカル環境の確認
nodeのパスを確認します
which node
mcpServer.jsのパスを確認します
realpath mcpServer.js
2. SaaSus Platform のAPIキー情報の取得
SaaSus API MCP Serverを使用するには、以下の環境変数を設定する必要があります これらの値は、SaaSus Platform のSaaS開発コンソールから取得できます。
SAASUS_PLATFORM_SAASID
: SaaS IDSAASUS_PLATFORM_APIKEY
: API キーSAASUS_PLATFORM_SECRETKEY
: シークレットキー
3. MCP Server の設定
手順1、2で取得した情報を設定ファイルに追加します:
{
"mcpServers": {
"saasusapis": {
"command": "node のパス",
"args": ["mcpServer.js のパス"],
"env": {
"SAASUS_PLATFORM_SAASID": "SaaS ID",
"SAASUS_PLATFORM_APIKEY": "API キー",
"SAASUS_PLATFORM_SECRETKEY": "シークレットキー"
}
}
}
}
注意:
node のパス
の部分は、フルパスに置き換えてください。
mcpServer.js のパス
の部分は、実際にクローンしたディレクトリのフルパスに置き換えてください。
4. Claude Desktop の再起動
設定を反映するため、Claude Desktopを再起動します。
5. Claude Desktop での動作確認
SaaSusの基本情報を取得してください
とお願いしてください。
正常に基本情報が取得できたら設定は完了です。
利用可能な機能
SaaSus API MCP Serverでは、SaaSus Platform の全APIエンドポイントが利用できます。
主な機能には以下が含まれます
Auth API
- 基本設定の取得・更新
- ユーザー管理
- テナント管理
- 認証設定
Pricing API
- メータリング
- 機能メニュー管理
- プラン管理
その他のAPI
- Billing API
- Communication API
- API Log API
- AWS Marketplace API
- Integration API
トラブルシューティング
よくある問題
1. サーバーが起動しない
- Node.jsのバージョンを確認してください(v16以上が必要、v20以上推奨)
- 依存関係が正しくインストールされているか確認してください
- 環境変数が正しく設定されているか確認してください
2. APIキーエラー
- SaaSus Platform のAPIキーが正しく設定されているか確認してください
- APIキーの権限が適切に設定されているか確認してください
- SaaS IDが正しく設定されているか確認してください
3. MCP接続エラー
- Claude Desktop または Cursor の設定ファイルのパスが正しいか確認してください
- 設定ファイルのJSON形式が正しいか確認してください
- アプリケーションを再起動してください
ツール一覧の確認
利用可能なツールを確認するには:
node index.js tools
このコマンドで、すべての利用可能なAPIエンドポイントとそのパラメータを確認できます。