DarkFunnels documentation

DarkFunnels — MCP サーバー

ホスト型のマルチテナント MCP サーバーです。アシスタントが WhatsApp AI セールスエージェントを操作し、実際の会話を監査して売上を逃している箇所を見つけたり、バージョン管理されたセールスプレイブックを元に戻せる状態で編集したり、商品カタログを管理したり、注文、在庫、指標を確認したりできます。すべての操作は、ご自身のアカウントの範囲内で行われます。

このリポジトリは公開されている窓口です。サーバー自体はクローズドソースです。

まずドキュメントをお読みください — アカウントは不要です

• 公開ドキュメント MCP サーバー（認証不要）：https://docs.darkfunnels.ai/mcp — すべてのページを検索し、読み取り専用の仮想ファイルシステムでドキュメントを閲覧できます。 レジストリエントリー：ai.darkfunnels/docs。
• スキルファイル：https://docs.darkfunnels.ai/skill.md — npx skills add https://docs.darkfunnels.ai。
• プレーンテキスト版：https://docs.darkfunnels.ai/llms.txt および https://docs.darkfunnels.ai/llms-full.txt。ドキュメントの URL の末尾に .md を追加してください。

接続

https://mcp.darkfunnels.ai/mcp?features=all

• トランスポート： Streamable HTTP、ステートレス。SSE はありません。/mcp への GET／DELETE は 405 を返します。
• 認証： 動的クライアント登録を使用する OAuth 2.1。こちらに申請する必要も、ウェイティングリストもありません。DarkFunnels アカウントがあれば接続できます。
• 検出： https://mcp.darkfunnels.ai/.well-known/oauth-protected-resource/mcp （RFC 9728）。認証なしの呼び出しは、WWW-Authenticate: Bearer resource_metadata=… ヘッダー付きで 401 を返します。この仕組みにより、準拠クライアントは独自に認証フローを開始できます。

ダッシュボードで使用しているものと同じアカウントで認証してください。別のアカウントで認証すると、その別の（おそらく空の）ワークスペースに接続されます。アシスタントが商品がないと言う場合は、まずアカウントを確認してください。接続中のアカウントは whoami ツールで確認できます。

用途

DarkFunnels は、企業の WhatsApp に AI セールスエージェントを導入します。企業はダッシュボードから QR コードをスキャンして、すでに使用している電話番号を接続します。WhatsApp Web と同じリンク済みデバイスの仕組みを使用するため、承認を得るための Meta Cloud API アプリケーションも、提出が必要なメッセージテンプレートも、会話ごとの料金もありません。DarkFunnels は Meta の製品ではなく、Meta とは提携していません。

このサーバーを通じて、オーナー自身のアシスタント（Claude、ChatGPT、Codex、その他の MCP クライアント）がワークスペースを操作します。

接続範囲の指定

4 つのクエリパラメーターで、アシスタントに許可する操作を決定します。

• ?features= — 明示的なリストを指定すると、デフォルトのセットを置き換えます。追加ではありません。?features=all が推奨値です。接続後に公開されたグループも含め、カタログ全体を使用できます。_write グループには、対応する読み取りグループが常に含まれます。
• ?read_only=true — all を含む他のすべての設定より優先され、すべての書き込み操作を無効にします。
• ?pii=full — デフォルトではマスクされている顧客の電話番号をマスク解除します。
• ?agent=<uuid> — 接続先を 1 つのセールスファネルに固定します。

?features= を指定しない場合、デフォルトのセットは読み取り専用です。ただし、顧客へのタグ付けという非破壊的な書き込み操作が 1 つ含まれます。

ツール

14 の機能グループにわたる 44 個のツールがあります。すべてのツールに title と、該当する readOnlyHint または destructiveHint が宣言されているため、クライアントは実行しようとしている操作をオーナーに表示できます。

ソースコードから生成された完全なリファレンス： https://docs.darkfunnels.ai/en/reference/tools

ツールのタイトルと説明はスペイン語で記述されています。これは意図的なものです。スペイン語を話す事業主がユーザーである製品で、実際の運用上の問題をもとに推敲され、コネクターがモデルに送信する正確なテキストです。翻訳すると、実在しないツールの説明になってしまいます。

決して行わないこと

このコネクターが資金を移動することはなく、支払いを実行することもできません。注文と売上のデータは読み取り専用です。ツールを通じて支払いを開始、確定、または返金することはできません。

セールスファネルを作成するツールが 1 つあり、サブスクリプションの利用枠を消費します。支払いを開始することはありません。利用枠の上限に達すると呼び出しは失敗し、購入手続きはオーナーが DarkFunnels のダッシュボードで行います。

こちらを試してください

1. 「昨日のWhatsAppでの会話を確認して、どこで売上を逃しているか教えてください。」
2. 「営業エージェントのマニュアルを読み、クロージングの章の改善案を提案してください。承認したら保存してください。」
3. 「3日以上返信がない顧客を一覧にして、それぞれの顧客に再び連絡するためにエージェントが送るメッセージの草案を作成してください。」

リンク

• エージェントガイド：https://darkfunnels.ai/agents
• ドキュメント（英語）：https://docs.darkfunnels.ai/en
• 接続 URL パラメーター：https://docs.darkfunnels.ai/en/reference/connection-url
• セキュリティとプライバシー：https://docs.darkfunnels.ai/en/security
• プライバシーポリシー：https://darkfunnels.ai/privacy
• スキルと Claude Code プラグイン：https://github.com/darkfunnels-ai/optimind-skills

レジストリ

公式 MCP レジストリに ai.darkfunnels/whatsapp-sales-agent として公開されています。 server.json を参照してください。