サポート
ドキュメンテーション

AIアシスタントをSuperSaaSに接続する

SuperSaaSはMCP(Model Context Protocol)サーバーを提供しています。ClaudeやChatGPTなどのAIアシスタントが自然言語でスケジュールを管理できるようになります: 空き状況の確認、予約の作成と変更、ユーザーの検索など、さまざまな操作が可能です。 アシスタントはあなたのアカウントと同じアクセス権を持つため、接続情報はパスワードと同様に慎重に取り扱ってください。

できること

設定後、AIアシスタントに次のような質問や依頼ができます:

  • 「明日の予約は何がありますか?」
  • 「来週、30分の相談枠を見つけて、jane@example.comで予約してください」
  • 「昨日から変更された予約はありますか?」
  • 「jim@exampleというユーザーをパスワード’secret’で新規作成し、2,000円分のクレジットを付与してください」
ほとんどのアシスタントは重要な変更の前に確認を求めますが、接続はあなたの管理者権限で動作することを忘れないでください。

クライアントの選択

ほとんどのユーザーはOAuthで接続することをお勧めします。サーバーURLを入力し、ブラウザでSuperSaaSにログインしてアクセスを承認するだけです。

OAuthに対応したクライアントには、このサーバーURLをご利用ください:https://www.supersaas.jp/mcp

ChatGPT

ChatGPTはサーバーURLを入力し、SuperSaaSで接続を承認することで接続できます。 カスタムコネクタを利用するには有料プラン(Plus、ProまたはBusiness)が必要です。

  1. https://chatgpt.comにアクセスして接続します。ウェブ版をご利用ください。ChatGPTのモバイルアプリやデスクトップアプリにはまだMCPオプションがありませんが、接続後はアプリからもツールを利用できます。
  2. Settings > Appsを開き、Advanced settingsまでスクロールして Developer modeを有効にします。
  3. Appsに戻り、Create appを選択し、名前を「SuperSaaS」として 接続先に「https://www.supersaas.jp/mcp」と入力します。
  4. AuthenticationOAuthが選択されていることを確認し、確認チェックボックスをオンにしてコネクタの作成を完了します。 接続するとブラウザでSuperSaaSのページが開くので、ログインして 承認をクリックすると、ツールが利用可能な状態でChatGPTに戻ります。

Claude(デスクトップアプリ・ウェブアプリ)

ClaudeはカスタムコネクタとしてSuperSaaSに接続します。必要なのはサーバーURLのみで、ブラウザでSuperSaaSにログインして接続を承認してください。

  1. ClaudeでSettings > Connectorsを開き、 Add custom connectorをクリックします。
  2. 「SuperSaaS」などの名前を入力し、サーバーURL (https://www.supersaas.jp/mcp)を貼り付けてAddをクリックします。
  3. Connectをクリックします。ブラウザでSuperSaaSのページが開くので、 アカウント名とパスワードでログインし(まだログインしていない場合)、承認をクリックします。
  4. Claudeに戻ると、チャット入力欄のツールアイコンの下にSuperSaaSのツールが一覧表示されます。

OAuth非対応クライアントの手動設定

一部のクライアントはまだブラウザのログインフローに対応していません。これらのクライアントにはサーバーURLと、Bearer …で始まるAuthorizationの値が必要です。 この値を確認するには、AIアシスタントを接続するをクリックしてください。ページが追加セクション付きで開きます。 表示するをクリックしてAuthorizationコードを確認します。

後からキーを更新するをクリックするとAuthorizationの値が変わり、それを使用している接続済みのアシスタントは新しい値に更新するまで動作しなくなります。

Claude Code(ターミナル)

以下のコマンドを実行し、プレースホルダーをあなたのAuthorizationの値に置き換えてください:

claude mcp add supersaas --transport http https://www.supersaas.jp/mcp \
  --header "Authorization: Bearer ここに値を貼り付けてください"

Codex

最も簡単な方法はCodexアプリを使うことです:

  1. CodexでSettingsを開きます。
  2. MCP serversに移動し、Addをクリックします。
  3. リモート/HTTPサーバーを選択し、サーバーURLを入力します。
  4. Authorizationという名前のHTTPヘッダーを追加し、Authorizationの値を設定します (Bearerという単語を含む)。
  5. サーバーを保存して新しいCodexチャットを開始します。SuperSaaSのツールがそのチャットで 使用可能になっているはずです。

ターミナルを使うか、Codexを手動で設定する場合は、~/.codex/config.tomlを編集し (存在しない場合は作成)、以下を追加します:

[mcp_servers.supersaas]
url = "https://www.supersaas.jp/mcp"
http_headers = { "Authorization" = "Bearer ここに値を貼り付けてください" }

Codexを再起動するとSuperSaaSのツールが自動的に表示されます。ターミナルでは codex mcp listで接続を確認でき、Codex内では/mcpで 接続されたサーバーを確認できます。

Visual Studio Code(GitHub Copilot)

VS CodeではMCPサーバーがGitHub Copilotのチャットのエージェントモードで使用されます。Copilotのサブスクリプションが必要です(無料プランでも利用できます)。

  1. コマンドパレット(Ctrl/Cmd + Shift + P)を開き、 MCP: Add Serverを実行します。
  2. HTTPを選択し、サーバーURLを入力します。
  3. mcp.jsonファイルが開いたら、headersエントリを追加して サーバー定義が次のようになるようにします:
{
  "servers": {
    "supersaas": {
      "type": "http",
      "url": "https://www.supersaas.jp/mcp",
      "headers": {
        "Authorization": "Bearer ここに値を貼り付けてください"
      }
    }
  }
}
  1. Copilotのチャットパネルを開き、モードドロップダウンをAgentに切り替え、 ツールアイコンをクリックしてSuperSaaSのツールが一覧に表示されていることを確認します。

その他のMCPクライアント(Cursor、Le Chatなど)

カスタムヘッダーに対応したリモートMCPサーバーをサポートするクライアントであれば動作します。 クライアントがサーバーの詳細を求めた場合は、以下を使用してください:

  • タイプ / トランスポート: Streamable HTTP
  • URL: サーバーURL(例:https://www.supersaas.jp/mcp
  • ヘッダー: AuthorizationにAuthorizationの値を設定 (Bearerという単語を含む)
JSONファイルで設定するクライアント(Cursorのmcp.jsonなど)の場合は以下のようになります:
{
  "mcpServers": {
    "supersaas": {
      "url": "https://www.supersaas.jp/mcp",
      "headers": {
        "Authorization": "Bearer ここに値を貼り付けてください"
      }
    }
  }
}