AIアシスタントを連携する
Claude、ChatGPT、その他のMCPクライアントをクライアントポータルに接続できます。アシスタントはプロジェクト、請求書、サポートチケット、サイトの状態、ファイルを読み取れます。ProとUltraのプランでは、正確なプレビューを確認した後に限り、チケットの作成や変更依頼の送信も行えます。
ツールと制限事項
プランごとに上限が設定されています。サーバーは、キーの数、キーごとの1分あたりのリクエスト数、アカウント全体の月間ユニット数を適用します。
Basic
無料読み取りのみ。このプランでは書き込みはできません
プロジェクト、請求書、サポートチケット、サイト状況、プロジェクトファイル、月次レポートの閲覧。
Pro
月額 3,000,000 トマン読み取りと確認済みの書き込み
すべての読み取りツールに加え、確認済みの書き込み：サポートチケットの作成と返信、変更依頼とFarrメッセージの送信、ファイルのアップロード、コンテンツ下書きの作成と更新、提案の承諾または辞退。各書き込みはまずプレビューされ、承認された後にのみ適用されます。
Ultra
月額 5,000,000 トマンProのすべて、さらに一括操作とWebhook
Proのすべてに加え、チケットの一括操作（bulk_ticket_reply、bulk_ticket_close、bulk_actions。1回の呼び出しで最大20件）、Webhook（webhook_list、webhook_create、webhook_delete）、定期的な月次レポート（scheduled_reports、scheduled_reports_get）。
安心設計：支払い・権限変更操作の完全排除
アシスタントAPIには請求書の支払いや送金、アカウント所有権の変更、キー管理を行うツールは一切含まれていません。請求書は閲覧のみ可能で、お支払いはポータルからご自身で行っていただきます。
アシスタントキーの発行手順
クライアントポータルから3ステップでキーを発行できます。
1. ポータルにログイン
クライアントポータルにログインし、メニューから「アシスタント連携」を開きます。
2. キーの発行
「キーを作成」をクリックし、3〜60文字の名前を入力（例:「Claude Code - ラップトップ」）、権限と有効期限を選択します。発行には再認証が必要です。
3. キーをコピーして保存
完全なキーは発行直後の1度しか表示されません。サーバーにはSHA-256ハッシュのみ保存されます。紛失した場合は失効させて再作成してください。
ClaudeおよびChatGPTとの接続方法
MCP Streamable HTTPトランスポートを使用し、BearerキーまたはOAuth認証で連携します。
Claude Codeおよび各種MCPクライアント
Claude Codeの.mcp.jsonなど、サーバーURLとヘッダーを設定できるツールに以下を追加し、キーを設定してください:
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPTおよびWebアシスタント
このURLをカスタムコネクタとして追加し、案内に従ってログイン認証（OAuth）を行います。この方法ではキーは不要です。
書き込み操作における「プレビューと確認」の仕組み
変更は最初の呼び出しで直接適用されることはありません。
アシスタントが書き込みツールを呼び出すと、サーバーは要求内容を保持し、10分間有効なワンタイム確認トークンを含むプレビューを返します。アシスタントがお客様の同意を得て確認ツールを実行して初めて適用されます。トークンは1回のみ有効で、同一引数・同一アカウントのみで動作します。
検証済みツールリファレンス
クライアントエンドポイントが提供する主なツールと、プレビュー後に使う確認ツールです。プランに含まれないツールは plan_required メッセージとともに拒否されます。
| ツール名 | アクセス種別 | 機能説明 |
|---|---|---|
| projects_list | 読み取り | 最大50件のプロジェクト一覧を表示（コード、名称、ステータス、進捗、完了予定日）。 |
| invoices_list | 読み取り | 最大25件の請求書一覧を表示（期日、合計、支払済額、残高、状態）。openOnlyで未払いのみ絞り込み可能。下書きや支払いリンクは除外。 |
| tickets_list | 読み取り | 最大50件のサポートチケット一覧を表示（ステータス、優先度、最終返信日時）。 |
| ticket_get | 読み取り | 指定チケットのメッセージ履歴を取得（最大100件）。内部メモは除外されます。 |
| ticket_create | 確認付き書き込み | 優先度「低」または「通常」のサポートチケットを下書き作成。プレビュー確認後に正式作成。 |
| ticket_reply | 確認付き書き込み | 進行中チケットへの返信を下書き作成。完了済みチケットには返信不可。確認後に送信。 |
| change_request_create | 確認付き書き込み | プロジェクトへの変更リクエストを下書き作成。プレビュー確認後に正式適用。 |
| site_status | 読み取り | 連携サイトのドメイン状態、訪問者数・PV数（24時間および7日間）、稼働率、未解決エラー件数を表示。 |
| files_list | 読み取り | プロジェクトストレージ内のファイル一覧を取得（1ページあたり最大100件、フォルダ指定可能）。 |
| file_link | 読み取り | 保存済みファイルのダウンロードリンクを生成（有効期限15分）。 |
| report_monthly | 読み取り | 月次サマリーを取得（過去12か月対応）：プロジェクト状況、チケット件数、サイト状態、請求情報、PDFリンク（15分有効）。 |
よくあるご質問
アシスタント連携、セキュリティ、利用制限に関するよくあるご質問。
AIアシスタントが自動で請求書の支払いや決済を行うことはありますか？
いいえ。アシスタントAPIには決済や送金を行うツールは一切存在しません。請求書の確認のみ可能で、お支払いはポータル上でご自身で行っていただきます。
月間の利用枠上限に達した場合はどうなりますか？
プランごとに、アカウント全体の月間ユニット予算があります。読み取りは1ユニット、書き込みのプレビューは3ユニットを消費します。月間の利用量がプランの予算に達すると、以降の呼び出しはツールの結果内で quota_exceeded エラーを返します（HTTP 429ではなくHTTP 200）。UTCの暦月が変わるまで続きます。
キーが漏洩した場合はどうすればよいですか？
ポータルの「アシスタント連携」画面から対象キーの「失効」を実行してください。以降のリクエストは即座に拒否されます。OAuth連携も同画面から解除可能です。
ChatGPTの接続にローカルブリッジソフトウェアは必要ですか？
不要です。標準的なHTTPSエンドポイントのため、クラウド型のアシスタントから追加ソフトウェアなしで直接接続いただけます。
AIアシスタントの活用を始めましょう
プランを選択するか、クライアントポータルからアシスタントキーを発行してください。