Sequentum MCP

Sequentum MCP

Sequentum MCP Server は、Model Context Protocol（MCP） を使用して AI コーディングアシスタントを Sequentum に接続し、AI ツールでウェブスクレイピングエージェントの作成、実行管理、スケジュール設定、分析などを行えるようにします。Sequentum は OAuth 認証を備えたリモート MCP サーバーをホスト・管理するため、インストールは不要です。

ツールリファレンス | プロンプトリファレンス | リソースリファレンス | トラブルシューティング | 変更履歴

主な機能

• エージェント管理：ウェブスクレイピングエージェントの作成、一覧表示、検索、詳細情報の取得ができます。
• 実行の自動化：リアルタイムのステータス追跡により、エージェントの実行を開始、停止、監視できます。
• スケジュール管理：cron 式を使用して、自動スケジュールを作成・管理できます。
• 分析と診断：実行統計、エラー分析、失敗に対する修正案を取得できます。
• スペースの整理：エージェントのワークスペースを管理し、複数のスペースを対象に一括操作を実行できます。

免責事項

sequentum-mcp は、MCP クライアントがウェブスクレイピングエージェントを 表示、実行、管理できるように、Sequentum アカウントのデータを公開します。認証情報を安全に保管し、 MCP クライアントからアクセスされたくない機密情報を共有しないでください。

はじめに

次の設定を使用して、Sequentum MCP サーバーをクライアントに追加します。

{
  "mcpServers": {
    "sequentum": {
      "url": "https://mcp.sequentum.com/mcp"
    }
  }
}

ほとんどのクライアントは OAuth 設定に対応しています。 Claude.ai と Claude Desktop はさらに簡単です。Sequentum MCP は Claude のコネクタディレクトリに掲載されているため、手動で入力するものはありません。詳しくは、以下の Claude.ai と Claude Desktop をご覧ください。他のクライアントでは、初回接続時に次の操作を求められます。

1. Sequentum アカウントでログインする
2. OAuth 認証を承認する
3. 必要な権限へのアクセスを許可する

認証が完了すると、すべてのツールをクライアントで利用できるようになります。クライアントごとの設定方法については、以下の クライアントの設定 をご覧ください。

クライアントの設定

以下からクライアントを選択して、具体的な設定手順を確認してください。特に記載がない限り、すべてのクライアントは https://mcp.sequentum.com/mcp のリモート OAuth サーバーを使用します。

Cursor

Cursor > Settings > Cursor Settings > MCP に移動し、プロンプトに従って Sequentum MCP サーバーを追加します。Cursor 1.0 以降は、ネイティブの OAuth と Streamable HTTP に対応しています。

上記の設定 を使用して mcp.json ファイルを編集し、サーバーを手動で追加することもできます。

Claude.ai と Claude Desktop

Sequentum MCP は Claude のコネクタディレクトリに掲載されているため、手動で入力する URL はなく、カスタムコネクタを作成する必要もありません。

1. Settings を開き、Connectors に移動します。
2. Directory を開いて Connectors を選択し、Sequentum MCP を見つけます。
3. Connect をクリックし、Sequentum アカウントでサインインします。

チームおよびエンタープライズのワークスペースでは、コネクタの利用可否は組織レベルで管理されます。そのため、メンバーが各自のアカウントから接続する前に、管理者が Sequentum MCP を有効にする必要がある場合があります。

**会話ごとに有効にする場合：**接続後、メッセージ入力欄の近くにある + ボタンをクリックし、Connectors を選択すると、個別の会話で Sequentum を有効にできます。

ChatGPT

Note: Sequentum アプリのディレクトリ承認が保留されている間は、開発者モードを使って接続できます。Apps & Connectors → Developer Mode は現在、Plus、Pro、Business、Enterprise、Education プランで利用できます（Education はウェブのみ）。Business／Enterprise／Education アカウントでは、詳細設定にアクセスできるのはワークスペースのオーナーと管理者のみです。一般メンバーにはこのオプションは表示されません。現在の利用条件については、OpenAI's Developer Mode documentationをご覧ください。

1. ChatGPT で、Settings > Apps & Connectors > Advanced settings に移動し、Developer mode を有効にします。
2. Settings > Apps & Connectors に移動し、Create app をクリックします（Developer mode を有効にすると表示されます）。
3. コネクタ名 Sequentum と URL https://mcp.sequentum.com/mcp を入力します。
4. Create をクリックします。OAuth を使って Sequentum アカウントにサインインするよう求められます。

接続したら、メッセージ入力欄の近くにある + ボタンから会話で Sequentum を有効にし、一覧からコネクタを選択します。

Claude Code

コネクタディレクトリから Sequentum MCP に一度接続すると（上記のClaude.ai and Claude Desktopを参照）、同じアカウントの Claude Code で利用できます。

直接追加する場合（プロジェクトごとに設定する場合や、スクリプトで使う場合に便利です）：

claude mcp add --transport http sequentum https://mcp.sequentum.com/mcp

次に、claude で Claude Code を起動し、/mcp と入力して OAuth のブラウザーフローを開始します。

VS Code / GitHub Copilot

Ctrl+Shift+P（macOS では Cmd+Shift+P）でコマンドパレットを開き、MCP: Add Server を選択します。Sequentum MCP サーバーの URL を入力します。

https://mcp.sequentum.com/mcp

Windsurf

Cascade の Configure MCP オプション（Cmd+L または Ctrl+L）から設定します。Sequentum MCP サーバーの URL を追加します。

https://mcp.sequentum.com/mcp

その他のクライアント

Sequentum MCP Server は標準の MCP プロトコルに準拠しており、以下をサポートする任意のクライアントで動作します。

• OAuth 認証（推奨）
• Streamable HTTP と自動 SSE フォールバック

クライアントの MCP 設定で、サーバー URL https://mcp.sequentum.com/mcp を使用してください。

サーバーは、優先されるクライアント識別方法としてクライアント ID メタデータドキュメント（CIMD）をサポートし、フォールバックとして動的クライアント登録（RFC 7591）を使用します。Cursor など、CIMD をサポートする MCP クライアントは、事前登録なしで独自の URL を client_id として使用できます。

ローカル stdio モード（廃止）

SEQUENTUM_API_KEY を使って stdio 経由でサーバーをローカル実行する方法（npx sequentum-mcp）は、3.0.0 で廃止されました。 代わりに https://mcp.sequentum.com/mcp に接続してください。クライアントのセットアップをご覧ください。Sequentum API キーは引き続きREST APIで使用できます。

使用例

接続したら、以下のプロンプトを試して、AI アシスタントで Sequentum のコンテキストを使い始めましょう。

What agents ran yesterday?
Run agent <agent name> now.
Is agent <agent name> still running?
What agents are scheduled to run today?
Download the extracted data from agent <agent name>.
How many records were found the last time <agent name> was run?
What is my current balance?
Which agents cost the most this month?
Schedule agent <agent name> to run every Monday at 9am.
Look at the run log for <agent name> run at 9:22am. What caused the agent to fail?
Show me the cost breakdown for agent <agent name> in January.
What were the most expensive runs for agent <agent name>?
How much did I spend on server time vs exports last week?

利用可能なツール

Sequentum MCP Server は、Sequentum プラットフォームを操作するための 9 カテゴリ、43 個のツールを提供します。詳しいドキュメントについては、ツールリファレンスをご覧ください。

• エージェント管理（5 個のツール）
  • list_agents
  • get_agent
  • search_agents
  • get_agent_search_count
  • get_personal_agent_count
• 実行管理（7 個のツール）
  • get_agent_runs
  • get_agent_run_summary
  • get_run_status
  • start_agent
  • stop_agent
  • kill_agent
  • delete_run
• ファイル管理（2 個のツール）
  • get_run_files
  • get_file_download_url
• バージョン管理（2 個のツール）
  • get_agent_versions
  • restore_agent_version
• スケジュール管理（8 個のツール）
  • list_agent_schedules
  • get_agent_schedule
  • create_agent_schedule
  • update_agent_schedule
  • enable_agent_schedule
  • disable_agent_schedule
  • delete_agent_schedule
  • get_scheduled_runs
• 請求とクレジット（6 個のツール）
  • get_credits_balance
  • get_spending_summary
  • get_credit_history
  • get_agents_usage
  • get_agent_cost_breakdown
  • get_agent_runs_cost
• スペース管理（6 個のツール）
  • list_spaces
  • get_space
  • get_space_agents
  • get_space_agent_count
  • search_space_by_name
  • run_space_agents
• 分析と診断（4 個のツール）
  • get_runs_summary
  • get_records_summary
  • get_run_diagnostics
  • get_latest_failure
• エージェントビルダー（3 個のツール）
  • start_agent_build
  • get_agent_build_status
  • stop_agent_build

構造化出力

43 個のツールのうち 36 個は outputSchema を宣言し、通常の テキストブロックに加えて structuredContent を返します（MCP 2026-07-28）。テキストブロックに変更はないため、構造化コンテンツを無視するクライアントには違いがありません。確認応答のみを返す 7 つのツール（stop_agent、kill_agent、 delete_run、restore_agent_version、delete_agent_schedule、enable_agent_schedule、 disable_agent_schedule）はテキストのみを返します。

• start_agent は非同期モードでは { "run": … }、同期モードでは { "data": … } を返します。
• リストを返すツール（list_spaces、get_space_agents、list_agent_schedules、 get_scheduled_runs、get_agent_versions、get_run_files）には配列スキーマがあります。2025 プロトコルリビジョンを使用するクライアントには、SDK が投影するように、{ "result": [...] } でラップされた形で返されます。
• ステータスのようなフィールドは数値コードです。それぞれの意味は各スキーマの説明に記載されています。

利用可能なプロンプト

サーバーには、一般的な複数ステップのワークフローを AI に案内する、再利用可能なプロンプトテンプレートが 9 個含まれています。詳しくはプロンプトリファレンスをご覧ください。

• デバッグと診断
  • debug-agent -- エージェントが失敗する原因を診断します
  • compare-runs -- 最後に成功した実行と失敗した実行を比較します
• ヘルスとモニタリング
  • agent-health-check -- エージェントの包括的なヘルス概要を表示します
  • daily-operations-report -- すべてのエージェントの日次運用レポートを作成します
  • space-overview -- スペース内のすべてのエージェントの概要を表示します
• 実行
  • run-and-monitor -- エージェントを起動し、完了するまでモニタリングします
  • schedule-agent -- スケジュールの作成手順を案内します
• 請求とコスト
  • spending-report -- 支出とクレジットのレポートを作成します
  • cost-analysis -- エージェント全体のコストを分析します
• エージェントの構築
  • build-agent-from-prompt -- 自然言語による説明から新しいエージェントを構築します
  • inspect-agent-draft -- 構築セッションを確認し、保存するか破棄するかを判断します

利用可能なリソース

サーバーは、AI クライアントが参照してコンテキストに取り込める、読み取り専用リソースを 18 個（静的リソース 7 個＋テンプレート 11 個）公開しています。詳しくは、リソースリファレンスをご覧ください。

• 静的リソース（7 個）
  • sequentum://agents -- すべてのエージェントの最初のページ
  • sequentum://spaces -- アクセス可能なすべてのスペース
  • sequentum://billing/balance -- 現在のクレジット残高
  • sequentum://billing/spending -- 月間支出の概要
  • sequentum://billing/agents-usage -- コスト上位のエージェント
  • sequentum://analytics/runs -- 過去 24 時間の実行
  • sequentum://analytics/upcoming-schedules -- 今後 7 日間に予定されている実行
• リソーステンプレート（11 個）
  • sequentum://agents/{agentId} -- 設定を含むエージェントの詳細
  • sequentum://agents/{agentId}/versions -- エージェントのバージョン履歴
  • sequentum://agents/{agentId}/schedules -- エージェントのスケジュール済みタスク
  • sequentum://agents/{agentId}/cost-breakdown -- 使用タイプ別のエージェントのコスト
  • sequentum://agents/{agentId}/runs -- エージェントの実行履歴
  • sequentum://agents/{agentId}/runs/{runId} -- 特定の実行のステータス
  • sequentum://agents/{agentId}/runs/{runId}/files -- 実行の出力ファイル
  • sequentum://agents/{agentId}/runs/{runId}/diagnostics -- 実行エラーの診断情報
  • sequentum://agents/{agentId}/latest-failure -- 最新の失敗に関する診断情報
  • sequentum://spaces/{spaceId} -- スペースの詳細
  • sequentum://spaces/{spaceId}/agents -- スペース内のエージェント

トラブルシューティング

スコープの適用をエンドツーエンドで検証する

pnpm run probe --env qa --mode log-only は、QA に対して実際の OAuth フロー（ブラウザーでのログインと同意、ループバックコールバック、PKCE）を実行し、3 つのスコーププロファイルのトークンを使って V1 API を直接およびこのサーバー経由で呼び出し、CloudWatch で Control Center のスコープチェックに関する行を確認します。docs/oauth-scope-probe.md を参照してください。

エラー	解決方法
OAuth ログイン画面が開かない	クライアントが OAuth と Streamable HTTP に対応していることを確認してください。クライアントを再起動してみてください。Claude.ai および Claude Desktop の場合は、設定ファイルではなくコネクターディレクトリから接続してください。
接続が拒否された	URL が https://mcp.sequentum.com/mcp であることを確認し、ネットワーク接続を確認してください。
API Error 401: Unauthorized	OAuth セッションが無効であるか、取り消されています。Sequentum MCP サーバーを切断して再接続し、再度サインインしてください。
再認証を求められる、または Insufficient Scope: This action requires the "…" scope が表示される	接続に、ツールが必要とする権限が付与されていません。サーバーは、このような呼び出しに対して、必要なスコープを示す HTTP 403 insufficient_scope チャレンジを返します。ステップアップ認証に対応したクライアントでは、承認を求められます。それ以外の場合、または Insufficient Scope メッセージが表示された場合は、Sequentum MCP サーバーを切断して再接続し、求められた権限を承認してください。再接続直後に再発する場合、クライアントに古いスコープリストがキャッシュされている可能性があります。コネクターの OAuth 設定を確認してください。
API Error 404: Not Found	エージェント、実行、またはファイルが存在しないか、アクセス権がありません。
API Error 429: Too Many Requests	レート制限を超えています。少し待ってから再試行してください。

その他のトラブルシューティングについては、トラブルシューティングガイドを参照してください。

HTTP モードの設定

mcp.sequentum.com のホスト型サーバーは、3.0.0 時点で唯一のトランスポートである Streamable HTTP トランスポートを、独自のデプロイ設定で実行しています。以下の環境変数で、このトランスポートのキャッシュ、レート制限、プロキシの信頼設定を調整できます。これらはこのソースの読者向けに記載されています。セルフホスト可能なデプロイはサポートされておらず、コンテナーイメージも公開されていません。

HTTP モードは 2.0.0 以降、ステートレスです。 Mcp-Session-Id ヘッダーはなく、サーバー上にクライアントごとのセッション状態もありません。各リクエストは、新しい MCP サーバーインスタンスによって個別に処理されます。GET /mcp は SSE ストリームを開かなくなり、現在は 405 Method Not Allowed を返します（リクエストが未認証の場合は、先に 401 を返します）。破棄すべきセッションがないため、DELETE /mcp は何もせず、常に 200 を返します。MAX_SESSIONS は読み込まれなくなりました。

変数	デフォルト値	説明
PORT	3000	HTTP サーバーのポートです。
SEQUENTUM_API_URL	https://dashboard.sequentum.com	このサーバーがプロキシする Sequentum API のベース URL です。
SEQUENTUM_OAUTH_ISSUER	SEQUENTUM_API_URL の値	/.well-known/oauth-protected-resource で公開される、このデプロイの OAuth 発行者識別子です。クエリ、フラグメント、ユーザー情報を含まない絶対 https URL であり、認可サーバーの issuer と完全に一致する必要があります。API のベース URL と公開 OAuth 発行者が異なる場合にのみ設定してください。不正な値が指定されると、起動が拒否されます。
MCP_CANONICAL_ORIGIN	リクエストの Host ヘッダーから導出	受信した OAuth トークンの aud クレームを検証する際に使われる、このサーバーのリソース識別子です。公開オリジン（例：https://mcp.sequentum.com）に設定してください。使用されるのはオリジンのみです。値は new URL(...).origin を通して正規化されるため、末尾のスラッシュやパスがあっても問題ありません。また、このオリジン上の任意のパスを示す aud が受け入れられます。未設定の場合、または new URL で解析できない値が設定された場合、サーバーは起動時に一度だけ警告し、呼び出し元が指定した Host にフォールバックします。別のオリジンを示す aud はログに記録されますが、拒否されません。
HOST	0.0.0.0	HTTP サーバーのバインドアドレスです。
LIST_CACHE_TTL_MS	3600000（1 時間）	キャッシュ可能なリスト形式の結果（tools/list、prompts/list、resources/list、resources/templates/list、server/discover）に付加される鮮度のヒント（ttlMs）です。0 以上の整数文字列を指定する必要があります。不正な値を指定すると、黙って切り捨てられるのではなく、起動時に即座に失敗します。
MCP_RATE_LIMIT_WINDOW_MS	60000（1 分）	/mcp エンドポイントに適用されるレート制限のウィンドウです。
MCP_RATE_LIMIT_MAX	100	プロセスごと、IP ごとの、ウィンドウあたりの /mcp リクエストの最大数です。水平方向にスケールする前に、以下の「レプリカ間のレート制限」を参照してください。
TRUST_PROXY	true	Express の trust proxy 設定に渡されます。true、false、ホップ数（例：1）、または CIDR/IP のカンマ区切り許可リストを指定できます。既知の弱点があるため、以下の「TRUST_PROXY とレート制限の回避」を参照してください。
REQUIRE_AUTH	true	/mcp の OAuth ベアラートークン要件を回避するには、false に設定します。ローカルテスト専用です。接続は成功しますが、有効なバックエンドトークンがないとツールは失敗します。

レプリカ間のレート制限

レート制限はプロセスごとに適用され、req.ip をキーとしており、レプリカ間で共有される状態は保持しません。ステートレスなトランスポートにはセッションアフィニティがないため、特定のクライアントのリクエストが単一のレプリカに固定されることはありません。そのため、ロードバランサーの背後で N 個のレプリカを水平方向にスケールするデプロイでは、クラスター全体の実質的な上限はウィンドウあたり MCP_RATE_LIMIT_MAX ではなく、N × MCP_RATE_LIMIT_MAX になります。特定の全体レートを維持するには、MCP_RATE_LIMIT_MAX をレプリカ数で割ってください。

TRUST_PROXY とレート制限の回避

デフォルトの TRUST_PROXY=true では、Express はすべてのプロキシホップを信頼し、クライアントが指定した X-Forwarded-For ヘッダーの左端の値から req.ip を解決します。 レートリミッターは req.ip をキーにするため、そのヘッダーの値を単純に切り替えるクライアントは レート制限を完全に回避できます。リバースプロキシの背後で実行しても、それだけでは解決しません。cloudflared や ngrok などのトンネルは X-Forwarded-For を上書きするのではなく追加するため、 TRUST_PROXY が正しく設定されていない限り、攻撃者が指定した左端の値が残ります。

対策として、TRUST_PROXY をサーバーの前にある信頼できるリバースプロキシホップの正確な数（例：1）に設定するか、 信頼できるプロキシの CIDR/IP 許可リストをカンマ区切りで設定してください。これにより、Express はクライアントが指定したヘッダーを 信頼するのではなく、正しいホップから req.ip を導出します。このリポジトリはデプロイ環境の構成を把握していないため、 意図的に、より安全なデフォルト値を選択していません。

**重大度：**これは不正利用／DoS 保護の回避であり、認証やデータ漏えいの問題ではありません。アカウントデータは漏えいせず、通常なら拒否されるツール呼び出しが成功することもありません。クライアントがレート制限を回避できるだけです。

CORS オリジン許可リスト

MCP サーバーにブラウザー（例：Claude のウェブアプリや ChatGPT コネクター）からアクセスすると、Origin ヘッダーが許可リストと照合されます。デフォルトで、次のオリジンが許可されています。

• https://claude.ai、https://claude.com と、すべてのサブドメイン（例：team.claude.ai）
• https://chatgpt.com、https://platform.openai.com と、chatgpt.com 配下のすべてのサブドメイン（例：connector.chatgpt.com）
• https://glama.ai と、すべてのサブドメイン（Glama のブラウザーベース MCP インスペクター用）
• https://dashboard.sequentum.com
• https://mcp.sequentum.com
• DEBUG=1 の場合の http://localhost:<port>、http://127.0.0.1:<port>、http://[::1]:<port>

独自のオリジン（例：社内ダッシュボード）を追加するには、ALLOWED_ORIGINS 環境変数に、完全一致するオリジンをカンマ区切りで設定します。

ALLOWED_ORIGINS="https://my-dashboard.example.com,https://other.example.com"

これらのオリジンはデフォルト値に追加されるため、Claude、ChatGPT、Sequentum からのアクセスは引き続き許可されます。環境変数ではワイルドカードと正規表現はサポートされていません。サブドメインのワイルドカードが必要な場合は、src/server/cors.ts に RegExp エントリーを直接追加してください。

注： Origin の照合では大文字と小文字が区別され、パスやクエリ文字列は含まれません。ネイティブの MCP クライアント（Cursor、Claude Desktop、Claude Code）は Origin ヘッダーを送信しないため、この許可リストの影響を受けません。

開発

このリポジトリでは npm ではなく pnpm を使用します。npm install は意図的に拒否されます。 Node 22 以降が必要です（.nvmrc では 24 が指定されており、Docker イメージでも使用されています）。Corepack は package.json で指定されたバージョンの pnpm をインストールします。Node 22 と 24 には同梱されています。Node 25 以降では、 まず npm install -g corepack でインストールしてください。

corepack enable
pnpm install
pnpm test
pnpm run build

pnpm は、pnpm-workspace.yaml の allowBuilds にパッケージが記載されていない限り、依存関係のインストールスクリプトを実行しません。 依存関係の変更後に pnpm install が無視されたビルドスクリプトを報告した場合は、そのパッケージを追加してください。スクリプトが動作に必要なら true、それ以外なら false を指定します。

引数は npm の -- を付けずに、スクリプト名の直後に指定します （pnpm run probe --env qa --mode log-only）。pnpm は -- をスクリプトに渡します。

プライバシーポリシー

Sequentum MCP サーバーは、AI アシスタントを通じてお客様が行うリクエストに応える目的に限り、エージェントのメタデータ、実行履歴、スケジュール済みタスク、請求情報、出力ファイルなど、お客様の Sequentum アカウントデータにアクセスします。デフォルトでは、MCP サーバーは MCP クライアントと Sequentum API の間で認証済みプロキシとして動作します。リクエストデータは API に転送され、レスポンスは永続化や第三者との共有を行わずにクライアントへ返されます。

運用担当者は、トラブルシューティングのため、DEBUG=1 環境変数を使って詳細なリクエストログを有効にできます。このモードでは、サーバーは Authorization、Cookie、x-api-key ヘッダーをマスキングしますが、リクエストボディ（ツールの引数を含む場合があります）を stderr に書き込みます。ホスト型サーバーの mcp.sequentum.com は DEBUG=1 で実行されません。

Sequentum のプライバシーポリシー全文については、https://www.sequentum.com/privacy-policyをご覧ください。

リンク

• Sequentum MCP サーバー
• Sequentum ダッシュボード
• Sequentum API ドキュメント
• Model Context Protocol

ライセンス

MIT © Sequentum