アシスタントに設定を任せる
この指示をAIアシスタントに貼り付けてください。公式セットアップガイドを読み、接続手順を案内します。
agenthouse DealDeskへの接続を設定してください。
ガイド: https://agenthouse.org/ja/dealdesk/connect.md
公式プラグイン手順: https://github.com/agenthouse-org/dealdesk-plugin/blob/main/install-for-agents.md
MCPサーバーURL: https://api.agenthouse.org/mcp/dealdesk
agenthouseでのサインイン(OAuth)を使ってください。このホストがブラウザを開けない場合を除き、APIキーから始めないでください。
APIキーをこのチャットに貼り付けるよう求めないでください。自分で入力する場所を教えてください。
完了したら、接続確認のために未完了のDealDeskカードを一覧表示してください。
顧客データに関する責任DealDeskのツールは、接続したAIアシスタント、そのモデル提供者、同じ会話内の他のツールに顧客データや商談データを渡す場合があります。どのアシスタント、モデル、ツールを許可するかはお客様が判断し、データを適法に取り扱う責任を負います。
ChatGPT
Claude
Gemini
GitHub Copilot
Cursor, Claude Desktop, Codex
Open WebUI
OpenCode
OpenClaw
Hermes Agent
その他
ChatGPT(Web・デスクトップ)
agenthouseでサインイン
- ChatGPTの設定を開き、コネクタ(アプリ)の項目に移動します。ビジネスワークスペースでは、管理者が先にカスタムコネクタ(開発者モード)を許可する必要がある場合があります。
- DealDeskという名前で新しいコネクタを作成し、下のサーバーURLを貼り付けて、認証方式にOAuthを選択します。
- agenthouseでサインインし、DealDeskプロジェクトを選んでアクセスを許可します。
- 新しいチャットを開始し、ツールメニューでDealDeskを有効にします。
https://api.agenthouse.org/mcp/dealdesk
Claude(claude.ai・Claudeアプリ)
agenthouseでサインイン
- Claudeの設定を開き、コネクタに移動します。TeamプランとEnterpriseプランでは、オーナーが組織向けにカスタムコネクタを追加します。
- DealDeskという名前でカスタムコネクタを追加し、下のサーバーURLを貼り付けます。
- 「接続」を選択し、agenthouseでサインインしてDealDeskプロジェクトを選び、アクセスを許可します。
- チャットのツールメニューでDealDeskを有効にします。
https://api.agenthouse.org/mcp/dealdesk
Gemini CLIはローカルのDealDeskブリッジ経由で接続します。GeminiのWebアプリでは、カスタムMCPアプリは現在、対象となる個人アカウントのGemini Sparkでのみ利用できます。利用可能な場合は、「その他」に表示されているサーバーURLを追加してください。
- Node.js 20以降とGemini CLIをインストールします。
- プロジェクトAPIキーを作成し、コンピューターの環境変数AGENTHOUSE_API_KEYに設定します。
- 下の設定を~/.gemini/settings.json(またはプロジェクトの.gemini/settings.json)に追加し、YOUR_PROJECT_IDを置き換えます。
- Gemini CLIを再起動し、/mcp listを実行します。DealDeskが接続済みとして表示されます。
{
"mcpServers": {
"dealdesk": {
"command": "npx",
"args": [
"-y",
"dealdesk-plugin"
],
"env": {
"AGENTHOUSE_API_URL": "https://api.agenthouse.org",
"AGENTHOUSE_API_KEY": "$AGENTHOUSE_API_KEY",
"AGENTHOUSE_PROJECT_ID": "YOUR_PROJECT_ID"
}
}
}
}
アクセス管理 → APIキーでプロジェクトAPIキーを作成してください。キーは一度だけ表示されます。プレースホルダー(YOUR_PROJECT_ID、表示されている場合はahk_YOUR_PROJECT_API_KEY)をご自身の値に置き換えてください。キーをチャットに貼り付けないでください。
アクセス管理を開く
VS CodeのGitHub Copilot
agenthouseでサインイン
VS Code 1.101以降は、OAuthによるリモートMCPに対応しています。保存後、サーバー項目の上にあるAuthを選び、agenthouseでサインインします。
- GitHub Copilotを使えるVS Code 1.101以降を開きます。
- コマンド「MCP: Open User Configuration」を実行するか、プロジェクトに.vscode/mcp.jsonを作成します。
- 下の設定を貼り付けて保存し、Authを選びます。agenthouseでサインインし、DealDeskプロジェクトを1つ以上選んでアクセスを許可します。
- エージェントモードでCopilot Chatを開き、DealDeskツールを有効にします。
{
"servers": {
"dealdesk": {
"type": "http",
"url": "https://api.agenthouse.org/mcp/dealdesk"
}
}
}
Cursor、Claude Desktop、Codex
agenthouseでサインイン
これらのアシスタントでは、agenthouseでのサインインが正規の手順です。プロジェクトAPIキーが必要なのは、ブラウザを開けない場合(CIなど)だけです。
- Cursor: DealDeskプラグインをインストールするか、下のサーバーURLをリモートMCPとして追加します。Claude DesktopとCodex: Node.js 20以降をインストールします。
- Claude Desktop: claude_desktop_config.jsonを開きます。Codex: MCP設定を開きます。下のローカルMCP設定を貼り付けます。
- agenthouseでサインインを完了し、DealDeskプロジェクトを1つ以上選んでアクセスを許可します。この手順ではAPIキーを作成しないでください。
- 新しいチャットを開始し、未完了のDealDeskカードを一覧表示して接続を確認します。
https://api.agenthouse.org/mcp/dealdesk
{
"mcpServers": {
"dealdesk": {
"command": "npx",
"args": [
"-y",
"dealdesk-plugin"
]
}
}
}
Open WebUI
agenthouseでサインイン
Open WebUI 0.6.31以降が必要です。MCPサーバーを追加できるのは管理者だけです。BearerやOAuth 2.1 (Static)ではなくOAuth 2.1を選びます。DealDeskをモデルのデフォルトツールにしないでください。DockerではWEBUI_SECRET_KEYを固定しないと、再起動後にサインインが失われます。
- Settings → Admin → Integrationsを開きます。External Tool ServersでAdd Connectionを選びます。
- TypeをMCP (Streamable HTTP)にします。下のサーバーURLを入力します。AuthはOAuth 2.1です。保存し、表示されたらRegister Clientを選びます。
- agenthouseでサインインし、DealDeskプロジェクトを1つ以上選んでアクセスを許可します。
- チャットを開き、+ → Integrations → ToolsでDealDeskを有効にします。デフォルトツールには設定しないでください。
https://api.agenthouse.org/mcp/dealdesk
OpenCode
agenthouseでサインイン
OpenCodeはリモートMCPのOAuthを自動検出し、DCRでクライアントを登録します。oauthをfalseにしないでください。
- プロジェクトまたはユーザー設定のopencode.json / opencode.jsoncを開きます。
- 下の設定をmcpに追加して保存します。
- OpenCodeを起動します。サインインが自動で始まらない場合は opencode mcp auth dealdesk を実行します。agenthouseでサインインし、DealDeskプロジェクトを1つ以上選んでアクセスを許可します。
- 新しい会話を開始し、未完了のDealDeskカードを一覧表示して接続を確認します。
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"dealdesk": {
"type": "remote",
"url": "https://api.agenthouse.org/mcp/dealdesk"
}
}
}
OpenClaw
agenthouseでサインイン
OpenClawはStreamable HTTPでリモートMCPに接続します。authはoauthにします。サインインした認証情報はGatewayに保存されます。
- Control UIのSettings → MCPを開き、Add serverを選びます。または下の設定をOpenClawの設定に貼り付けます。
- 名前はdealdesk、TransportはStreamable HTTP、URLは下のアドレス、Authはoauthです。
- Sign inを選ぶか、openclaw mcp login dealdesk を実行します。agenthouseでサインインし、DealDeskプロジェクトを1つ以上選んでアクセスを許可します。
- openclaw mcp doctor dealdesk --probe を実行し、未完了のDealDeskカードを一覧表示して接続を確認します。
{
"mcp": {
"servers": {
"dealdesk": {
"url": "https://api.agenthouse.org/mcp/dealdesk",
"transport": "streamable-http",
"auth": "oauth"
}
}
}
}
Hermes Agent
agenthouseでサインイン
Hermes Agent(Nous Research)はOAuth 2.1とPKCEのリモートMCPに対応しています。トークンは設定ファイルではなく ~/.hermes/mcp-tokens/ に保存されます。
- hermes mcp add --url https://api.agenthouse.org/mcp/dealdesk --auth oauth dealdesk を実行するか、下のブロックを ~/.hermes/config.yaml に貼り付けます。
- サインインが自動で始まらない場合は hermes mcp login dealdesk を実行します。
- agenthouseでサインインし、DealDeskプロジェクトを1つ以上選んでアクセスを許可します。
- Hermesを再起動するか /reload-mcp を実行します。未完了のDealDeskカードを一覧表示して接続を確認します。
mcp_servers:
dealdesk:
url: "https://api.agenthouse.org/mcp/dealdesk"
auth: oauth
その他のMCPクライアント
サインインまたはAPIキー
- クライアントがOAuth対応のリモートMCPサーバーをサポートしている場合は、サーバーURLを追加してagenthouseでサインインします。
- それ以外の場合は、下のコマンドでローカルのDealDeskブリッジを起動します。Node.js 20以降が必要です。
- ahk_YOUR_PROJECT_API_KEYとYOUR_PROJECT_IDをご自身の値に置き換えるか、クライアントの環境変数として設定します。
https://api.agenthouse.org/mcp/dealdesk
AGENTHOUSE_API_URL=https://api.agenthouse.org AGENTHOUSE_API_KEY=ahk_YOUR_PROJECT_API_KEY AGENTHOUSE_PROJECT_ID=YOUR_PROJECT_ID npx -y dealdesk-plugin
アクセス管理 → APIキーでプロジェクトAPIキーを作成してください。キーは一度だけ表示されます。プレースホルダー(YOUR_PROJECT_ID、表示されている場合はahk_YOUR_PROJECT_API_KEY)をご自身の値に置き換えてください。キーをチャットに貼り付けないでください。
アクセス管理を開く
接続を確認
新しいチャットを開始し、アシスタントに次のように尋ねてください:
未完了のDealDeskカードを一覧表示してください。