three.ws Concierge

ローカル

three.ws Concierge について

three.ws Concierge は、AI アシスタントから任意のウェブサイトの AI コンシェルジュに質問し、サイトに組み込むための埋め込みコードを生成できる MCP サーバーです。回答はページの実際の内容または指定したテキストに基づき、APIキーは不要です。サイトの情報を調べる方や、自社サイトにコンシェルジュを追加したい方に適しています。

主な機能

01指定したページの実際の内容に基づく回答
02独自のナレッジテキストを回答の根拠として指定
03script、web-component、npm などの埋め込みコード生成
04利用可能な 3D アバターの一覧表示

活用シーン

01製品ページに料金やプランの詳細を質問
02ブランドのアクセントカラーと挨拶を含む埋め込みコードの生成
03アバターを選択しサイトのコンシェルジュに設定

MCP 対応

concierge_ask、concierge_embed、concierge_avatars の 3 つのツールを公開し、MCP クライアントが質問、埋め込みコードの生成、アバターの一覧取得を行えるようにします。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "nirholas-concierge": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/concierge-mcp"
      ],
      "env": {
        "THREE_WS_BASE": "<THREE_WS_BASE>",
        "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
        "CONCIERGE_PAGE_TIMEOUT_MS": "<CONCIERGE_PAGE_TIMEOUT_MS>"
      }
    }
  }
}

起動コマンドnpx -y @three-ws/concierge-mcp

設定が必要な環境変数

THREE_WS_BASEBase URL of the three.ws API that serves POST /api/concierge, and the origin the generated embed snippets point at. Override only when self-hosting or targeting a preview deployment.

THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds for the concierge answer call. The answer streams over a free-first LLM chain that can fail over across providers, so the default leaves room for one slow rung.

CONCIERGE_PAGE_TIMEOUT_MSTimeout in milliseconds for fetching a page that concierge_ask grounds its answer in. Separate from the answer timeout so a slow site cannot consume the whole call.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@three-ws/concierge-mcp0.1.1stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
url	string	いいえ	回答の根拠にするウェブページ。ページを取得し、読み取り可能なテキストを抽出します。
lang	string	いいえ	返信言語を指定する BCP-47 言語ヒント。例："en"、"es"。
content	string	いいえ	url を渡さない場合に、回答の根拠として使用するページまたはドキュメントの生テキスト。
persona	string	いいえ	返信の口調に関する任意の指示。例："concise and technical"。
question	string	はい	自然言語で尋ねる質問。
siteName	string	いいえ	サイトまたは製品の表示名（回答の構成に使用）。省略した場合はページから推測します。
knowledge	string	いいえ	回答の根拠にする、厳選された信頼性の高い情報（FAQ、価格、ポリシー）。取得したページのテキストより優先されます。

詳細

@three-ws/concierge-mcp

あらゆるウェブサイトのAIコンシェルジュに、根拠に基づいた質問をして、サイトに追加するための埋め込みコードを生成できます。どのAIアシスタントからでも利用できます。

license

Model Context Protocol サーバーです。three.ws Concierge（話す3Dアバター付きの埋め込み可能なAIチャットウィジェット）を、stdio経由であらゆるAIアシスタントから利用できます。

ツールは3つあります。

ツール	機能	ネットワーク
`concierge_ask`	ウェブサイトのAIコンシェルジュに質問します。`url`を指定すると、そのページを取得し、実際のコンテンツ（タイトル、見出し、ナビゲーション、本文）に基づいて回答します。これにより、あらゆるウェブサイトに質問することができます。または、すでに手元にあるテキストから回答するために、`knowledge`／`content`を渡すこともできます。	無料のthree.wsレーン＋URLの取得
`concierge_embed`	ウェブサイトにコンシェルジュを追加する、すぐに貼り付けて使える埋め込みコードを生成します。1つの`<script>`タグ、`<three-concierge>`ウェブコンポーネント、npmスニペット、または命令型の`mount()`呼び出しを生成でき、アクセントカラー、アバター、あいさつ、厳選したナレッジ、提案プロンプトを設定できます。	オフライン
`concierge_avatars`	コンシェルジュに設定できる、リグ済みの3Dアバターを一覧表示します。	オフライン

APIキーも署名者も支払いも不要です。concierge_askは、公開されている無料のPOST /api/concierge回答レーンで動作します。他の2つは完全にローカルで動作するジェネレーターです。

インストール

npm install @three-ws/concierge-mcp

または、npxで実行します（インストール不要）。

npx @three-ws/concierge-mcp

クイックスタート

Claude Codeの場合、1行で設定できます。

claude mcp add concierge -- npx -y @three-ws/concierge-mcp

Claude Desktop／Cursorの場合（claude_desktop_config.jsonまたはmcp.json）：

{
	"mcpServers": {
		"concierge": {
			"command": "npx",
			"args": ["-y", "@three-ws/concierge-mcp"]
		}
	}
}

MCP Inspectorで機能を確認します。

npx -y @modelcontextprotocol/inspector npx -y @three-ws/concierge-mcp

活用例

ウェブサイトの実際のコンテンツに基づいて質問する：

concierge_askを使って、https://example.com/pricing から「Proプランには何が含まれていますか？」に回答してください

サーバーがページを取得して読み取り可能なテキストを抽出し、コンシェルジュの回答エンジンに送信します。ページに書かれていない内容を作り出さないよう指示された回答が返されます。

手元にあるテキストから質問する（URL不要）：

concierge_ask：question = 「返金可能な期間は？」、knowledge = 「返品は30日以内に受け付けています。」

サイト用のコピー＆ペーストできる埋め込みコードを生成する：

concierge_embedを使って、siteName「Acme」、accent「#f97316」、avatar「nova」、suggestions［「Acmeとは？」、「料金は？」］、flavor「script」を指定してください

サイトのHTMLに追加できる、正確な<script>タグが返されます。

先にアバターを選ぶ：

concierge_avatars → 続いて、気に入ったIDをconcierge_embedのavatarに指定します

ツールの詳細

`concierge_ask`

読み取り専用、オープンワールドです。

パラメーター	型	備考
`question`	string (required)	自然言語での質問です。
`url`	string (url)	回答の根拠とするページです。取得して内容を抽出します。
`siteName`	string	表示名です。省略した場合はページから推定されます。
`knowledge`	string	厳選された信頼性の高い情報です。抽出したテキストより優先されます。
`content`	string	`url` を渡さない場合に、根拠とする生テキストです。
`persona`	string	返答のトーンを指定します。
`lang`	string	BCP-47 のヒントです（例：`en`、`es`）。

url、knowledge、content のうち少なくとも 1 つが必要です。{ ok, question, answer, grounded_in, provider, model, endpoint } を返します。

`concierge_embed`

読み取り専用、冪等、オフラインです。

主なパラメーター：siteName、flavor（script | web-component | npm | imperative | all、デフォルトは all）、accent、avatar、customAvatar、position、theme、greeting、persona、knowledge、suggestions[]、endpoint、muted、open、noPicker、noTeaser、lang。{ ok, flavor, snippets, applied_config, docs } を返します。script、web-component、imperative のスニペットはすべてプレーン HTML に貼り付けてすぐ使えます（CDN のグローバルビルドを読み込みます）。npm のスニペットはバンドラーを使用するユーザー向けです。

`concierge_avatars`

読み取り専用、冪等、オフラインです。パラメーターはありません。{ ok, default, count, avatars, note } を返します。各アバターには id、name、tagline、style、framing が含まれます。

設定

すべて任意の環境変数です。

変数	デフォルト	用途
`THREE_WS_BASE`	`https://three.ws`	回答呼び出しの API オリジンと、埋め込みスニペットが接続するオリジンです。
`THREE_WS_TIMEOUT_MS`	`45000`	コンシェルジュの回答のタイムアウトです（LLM プロバイダー間でフェイルオーバーする場合があります）。
`CONCIERGE_PAGE_TIMEOUT_MS`	`12000`	`concierge_ask` でページを取得する際のタイムアウトです。

エラー

ツール呼び出しに失敗すると、MCP エラー結果（isError: true）が返されます。そのテキストは単一の JSON オブジェクト { "ok": false, "error": "<code>", "message": "…" } で、上流からの拒否の場合は status も含まれます。

`error`	意味	対処方法
`bad_request`	不正な引数です。`concierge_ask` に `url`／`knowledge`／`content` がない、`url` が http(s) ではない、または `avatar` の ID が不明です。	呼び出しを修正してください。
`unsupported_media`	取得した `url` が HTML／テキストページではありません。	読み取り可能なページを指定するか、`content` を渡してください。
`upstream_error`	回答エンドポイントがリクエストを拒否しました。`status` に HTTP コードが含まれます（`429` は無料枠の IP レート制限です）。	`status` に応じて対処してください。`429` の場合は時間をおいて再試行してください。
`stream_error`	回答ストリームが完了前に失敗しました。	再試行してください。
`timeout`	`THREE_WS_TIMEOUT_MS` 以内に回答が得られなかったか、ページ取得が `CONCIERGE_PAGE_TIMEOUT_MS` を超過しました。	再試行するか、タイムアウトを延長してください。
`network_error`	リクエストが API に到達しませんでした（DNS、オフライン、TLS）。	接続状態と `THREE_WS_BASE` を確認してください。
`bad_config`	`THREE_WS_TIMEOUT_MS` が正の数ではありません。サーバーの起動時（モジュール読み込み時）にスローされるため、リクエストを処理する前にプロセスが終了します。	環境変数を修正してください。

ウィジェットとの関係

このサーバーは、ブラウザーウィジェットである @three-ws/concierge のエージェント向けインターフェースです。同じ回答エンジン、同じアバターカタログ、同じグラウンディングモデルを MCP ツールとして公開することで、アシスタントが人間の訪問者と同じようにサイトのコンシェルジュを利用したり、コンシェルジュを導入したりできます。

ウィジェットとドキュメント：three.ws/concierge
リファレンスドキュメント：three.ws/docs/concierge
構築チュートリアル：three.ws/docs/tutorials/build-a-site-concierge

開発

npm test    # node --test, offline (registration, harvest, embed, SSE parsing)
npm start   # run the server over stdio

実行中の three.ws に対するライブのエンドツーエンドチェック（test/_manual-e2e.mjs）では、実際の stdio クライアントを通じて 3 つすべてのツールを実行します。実行方法については、ファイルの先頭にある説明を参照してください。

ライセンス

Apache-2.0。LICENSE を参照してください。公開されている three.ws API に対して無料で実行できます。

Markdown 対応

ログインしてコメント

基本情報

作者: nirholas
言語: node
バージョン: 0.1.1
トランスポート: stdio
掲載日: 2026年10月10日
最終更新: 今日
公式 Registry: io.github.nirholas/concierge-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

three.ws Concierge

three.ws Concierge について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@three-ws/concierge-mcp

インストール

クイックスタート

活用例

ツールの詳細

concierge_ask

concierge_embed

concierge_avatars

設定

エラー

ウィジェットとの関係

開発

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？

`concierge_ask`

`concierge_embed`

`concierge_avatars`