メインコンテンツまでスキップ

SaaSus API MCP Server 設定ガイド

概要​

SaaSus API MCP Serverは、Model Context Protocol (MCP) サーバーとして動作し、SaaSus APIをClaude DesktopやCursorなどのMCP互換クライアントから利用できるようにします。

注意

MCP クライアントの送信上限と日次上限はプランごとに異なります。
Free プランでは、大きなリクエストが拒否されることがあります。

前提条件​

  • 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 での設定​

注意

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 ID
  • SAASUS_PLATFORM_APIKEY: API キー
  • SAASUS_PLATFORM_SECRETKEY: シークレットキー

3. MCP Server の設定​

手順１、２で取得した情報を設定ファイルに追加します：

{
  "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
  • Analysis API

トラブルシューティング​

よくある問題​

1. サーバーが起動しない​

  • Node.jsのバージョンを確認してください（v16以上が必要、v20以上推奨）
  • 依存関係が正しくインストールされているか確認してください
  • 環境変数が正しく設定されているか確認してください

2. APIキーエラー​

  • SaaSus Platform のAPIキーが正しく設定されているか確認してください
  • APIキーの権限が適切に設定されているか確認してください
  • SaaS IDが正しく設定されているか確認してください

3. MCP接続エラー​

  • Claude Desktop または Cursor の設定ファイルのパスが正しいか確認してください
  • 設定ファイルのJSON形式が正しいか確認してください
  • アプリケーションを再起動してください
  • MCP クライアントは、プランやツール定義の大きさによって送信上限を超え失敗する場合があります。

ツール一覧の確認​

利用可能なツールを確認するには：

node index.js tools

このコマンドで、すべての利用可能なAPIエンドポイントとそのパラメータを確認できます。