Cherry Studio Agent にウェブツールを設定
確認済み HTTP MCP ツールを通じて公開 API に接続します。サービス接続、Agent への割り当て、対象応答を別々に検証します。モデル設定はウェブリクエストの入口ではありません。
- サービスを確認してから Agent に割り当て
- カスタムヘッダーと認証情報の分離を必須に
- 必要なツールと権限だけを有効化
承認された Web アクセス、開発、テスト、データ ワークフロー用。
プロジェクトに合った統合を選択してください
使用可能な最小のパスから始めて、必要に応じてツールやワークフローの複雑さを追加します。
セットアップ、リクエスト、検証
複雑な構成を追加する前に、1 つの検査可能なリクエストでワークフローを証明します。
API とツール機能を検証
信頼できる環境で許可済み対象をテストします。ヘッダー、タイムアウト、安全な認証に対応するツールを選び、モデルのプロバイダーには設定しないでください。
MCP サービスを追加して確認
MCP 設定で確認済みローカルコマンドやリモートサービスを追加します。ツール、引数、権限を調べ、未公開のホスト型 MCP URL は入力しません。
Agent に割り当てて結果を確認
動作中のサービスを必要な Agent に割り当て、読み取り専用リクエストを試します。x-cb-status、対象状態、本文を確認し、ツールがなければ割り当て、有効状態、承認待ちを調べます。
ツール接続前に API を検証
cURL は信頼できるバックエンドや端末で別途使います。デスクトップは確認済み HTTP MCP ツールを呼び出し、このコマンドを直接実行しません。
curl --include --request GET \
"https://api.cloudbypass.com/" \
--header "x-cb-host: example.com" \
--header "x-cb-apikey: ${CLOUDBYPASS_APIKEY:?}" \
--max-time 90
# POSIX shell example; set the key securely first.
# Check x-cb-status, target status and content.
# For V2 / V2s, add version and stable proxy parameters.Verify that the connected tool supports custom HTTP headers and secure credentials.
Target: https://example.com/ (replace with an authorized target).
Make one read-only request and inspect x-cb-status, target status and content.
Never put the API key in chat. Stop if the tool is unavailable.
Hosted MCP is planned; do not invent an endpoint.Cherry Studio の接続と Agent 割り当て
接続した MCP はすべての Agent に自動で割り当てられません。実際のバージョンに従い、ページはデータとして扱い、キーを会話、スキル、共有設定に含めないでください。
| チェックする | 何を検査するか | 次のアクション |
|---|---|---|
| 資格情報と範囲 | 資格情報、残高、および許可されたアクセスを確認する | IPをやみくもに変更するのではなく構成を修正する |
| バージョンとセッション | V2 / V2 の安定したプロキシとセッションを一致させる | プロキシの変更後に検証セッションを再構築する |
| 2つのステータスレイヤー | x-cb-status とターゲット HTTP のステータスを確認します | 200 応答でもログイン ページまたはチャレンジ ページである可能性があります |
| 出力と再試行 | コンテンツタイプ、予想されるフィールド、試行予算を確認してください | 構成エラーが発生した場合は停止します。一時的な再試行を制限する |
- 統合ガイド 共有パラメータとアクセスルール
- 公式クライアントドキュメント クライアントとバージョンに合わせて設定する
- サポートに連絡 リクエスト ID と編集されたエラーを共有する
統合を機能させる
アクセス戦略、実装手順、トラブルシューティングに関するタスク ガイドを選択してください。
開発とツールの統合
- AI エージェントの Web アクセス
研究助手やエージェント向けの Web 入力を準備します。
- MCP Web フェッチ ワークフロー
ツールと Web タスク間の接続を設計します。
ビジネスユースケース
- RAG の Web インジェスト
検証されたコンテンツをクリーニングおよび取り込みパイプラインに渡します。
- 販売見込み調査
Web サイトやパブリック ディレクトリを使用して企業を調査します。
よくある質問
今日はどの統合を使用すればよいでしょうか?
パブリック HTTP API から始めます。 OpenClaw は公開された Skill を使用できます。既存の HTTP MCP ツールは、カスタム ヘッダーと安全な認証情報をサポートする必要があります。ホストされた MCP サービスはまだ計画されています。
すべてのターゲットにアクセスできますか?
普遍的な保証はありません。関連するアクセス機能には、ターゲットおよびランタイム検証の対象となる Cloudflare JavaScript チャレンジ、Turnstile、DataDome、および Imperva / Incapsula が含まれます。この統合は、reCAPTCHA または hCaptcha のサポートを宣伝したり、アカウント権限を置き換えたりするものではありません。
API キーとプロキシ パスワードはどこに行けばよいですか?
実際のランタイムまたは信頼できるサーバーで安全な構成に保ちます。これらをブラウザーのコード、共有リポジトリ、プロンプト、スクリーンショット、または公開ログに配置しないでください。リモート サービスには別の環境があります。
MCP または Skill はページネーションと抽出を自動的に処理しますか?
デフォルトではありません。アクセス層はリクエストとレスポンスを処理します。ワークフローまたはサイト レシピは、ページネーション、フィールド抽出、重複排除、ログイン状態、およびビジネス固有の署名を処理します。無制限に再試行するのではなく、失敗を診断します。
スケールアップする前に 1 つのリクエストを検証する
ターゲットの互換性を確認してから、ワークフローをプロジェクトに組み込みます。