Weav

Weav.com Model Context Protocol (MCP)

Model Context Protocol (MCP) を使用して、AI エージェントが Weav ワークスペースに安全にアクセスし、操作できるようにする方法をご紹介します。

Weav の MCP サーバーは、Weav ワークスペースで利用できます。

このリポジトリでは、ワークスペースサーバー（com.weav/mcp、https://mcp.weav.com/mcp）について説明しています。ログインなしで料金や製品に関する質問に回答する、別の公開サーバーもあります。

Server	URL	Auth	Registry
Weav（このリポジトリ）	https://mcp.weav.com/mcp	OAuth	com.weav/mcp
Weav カスタマーサービス	https://weav.com/mcp	なし	io.github.dubdubdubco/weav-customer-service

公開サーバーは、受信トレイ、顧客、トレーニングデータ、ヘルプセンターのデータを読み取ることはできません。出典：dubdubdubco/weav-site-mcp。

Model Context Protocol とは？

MCP は、AI ツールやアプリケーションが Weav のデータやサービスに安全かつ標準化された方法で接続できるようにするプロトコルです。AI モデルに次の機能を提供する、体系化された方法です。

• Weav のデータ（会話、顧客、エージェントのトレーニングデータ、ヘルプセンターの記事）を検索、取得する
• Weav が提供する特定のツールや機能にアクセスする
• AI アシスタントを使用する際に、Weav ワークスペースに関するコンテキストを維持する

MCP の仕組み

Weav は、認証済みリモート MCP 仕様（ドキュメント）に準拠したリモート MCP サーバーをホストしています。このサーバーは AI ツールからのリクエストを処理し、安全なインターフェースを通じて Weav のデータにアクセスできるようにします。

接続 URL：

• ストリーミング可能な HTTP：https://mcp.weav.com/mcp

AI ツールまたはアプリケーションが Weav のデータにアクセスする必要がある場合：

1. ツールが Weav の MCP サーバーに接続します
2. ワークスペースの管理者またはオーナーが、ブラウザーで OAuth の同意を完了します
3. その後、ツールは該当するワークスペースの関連データや機能にアクセスできます
4. 接続は取り消されるまで有効です

MCP を使用するメリット

• 安全なアクセス：すべてのデータアクセスで認証と認可が行われます。同意を完了できるのは、ワークスペースの管理者またはオーナーのみです。
• 標準化されたインターフェース：さまざまな AI ツールで一貫した操作パターンを利用できます
• コンテキストの理解：AI アシスタントが Weav の受信トレイ、顧客、エージェントのトレーニングデータ、ヘルプセンターを把握できます
• 開発効率の向上：普段使用している AI ツールから、会話のトリアージ、顧客への返信、エージェントのトレーニングデータやヘルプセンターの記事の管理を行えます

利用可能なツール

Weav MCP サーバーは、ワークスペースを操作するための37 個のツールを提供します。内訳は、会話ツールが 4 個、顧客ツールが 2 個、エージェントのトレーニングデータ用ツールが 5 個、ヘルプセンター用ツールが 26 個です。

会話

search_conversations

Weav の受信トレイと同じ方法で、サポートの会話を検索します。

主な機能：

• 件名、顧客名、メールアドレスを照合します
• メッセージが 1 件以上ある会話のみを返します
• spam が true でない限り、スパムは除外されます
• 任意のフィルター：status（open、closed）、channel（email、chat）、limit（1～50）

get_conversation

最近のメッセージを含む会話を取得します。

主な機能：

• search_conversations が返す会話 UUID を使用します
• 会話のメタデータと最近のメッセージ履歴を返します

send_reply

ワークスペースのチームメイトとして、会話に返信を投稿します。

主な機能：

• conversation_id と content が必要です
• 接続中のワークスペースで返信を送信します

update_conversation

会話のステータス、優先度、担当者を更新します。会話は削除されません。

主な機能：

• status：open または closed
• priority：low、normal、high、urgent
• assignee_id と assignee_type（user または agent）。変更しない場合は省略し、担当者を解除する場合は null を送信します

顧客

search_customers

名前またはメールアドレスで顧客を検索します。

主な機能：

• 任意の query と limit（1～50）を指定できます

get_customer

顧客のプロフィール、会社、最近の会話を取得します。

主な機能：

• search_customers が返した顧客 UUID を使用します

エージェントのトレーニングデータ

以下は、kb_* ツールが管理する公開ヘルプセンターとは別に、Weav AI エージェントが回答の基にする情報源です。

search_training_data

タイトル、説明、タイプ、またはソースでエージェントのトレーニングデータ項目を検索します。

主な機能：

• type フィルターは任意です：text、url、file、video、qa
• limit（1～50）は任意です

get_training_data

単一のトレーニングデータ項目を取得します。

主な機能：

• search_training_data が返したトレーニングデータ UUID を使用します

add_training_data

テキスト、Q&A、またはウェブサイト URL をエージェントのトレーニングデータとして追加します。ワークスペース内のすべてのエージェントに、自動的にアクセス権が付与されます。

主な機能：

• type：text、qa、または url
• url はウェブサイトをクロールし、検出したページを使ってトレーニングします
• urls はサイトのほかの部分をクロールせず、指定したページのみを使ってトレーニングします

delete_training_data

トレーニングデータ項目を削除します。

主な機能：

• ウェブサイト／URL ソースの場合、検出された URL とチャンクも削除します

resync_training_data

既存の URL トレーニングデータ項目を再スクレイピングします。

主な機能：

• URL ソースのトレーニングデータ UUID が必要です

ヘルプセンターのナレッジベース

kb_* ツールは、*_training_data が管理するエージェントのトレーニングデータとは別に、ワークスペースの公開ヘルプセンターの記事とカテゴリーを管理します。

閲覧

kb_get_overview

ヘルプセンターの記事数と利用可能なロケールを取得します。

主な機能：

• パラメーターはありません
• 表示順のセクションを含みます

kb_list_categories

ヘルプセンターのカテゴリーを一覧表示します。

主な機能：

• limit（1～50、デフォルトは20）と page（デフォルトは1）は任意です

kb_list_sections

ヘルプセンターのセクションを表示順に一覧表示します。

主な機能：

• limit（1～50、デフォルトは20）と page（デフォルトは1）は任意です

kb_list_articles

ヘルプセンターの記事の概要を一覧表示します。

主な機能：

• フィルターは任意です：category_id または uncategorized、status（draft、published）、locale
• limit（1～50、デフォルトは20）と page（デフォルトは1）は任意です

kb_search_articles

ヘルプセンターの記事のタイトルと本文を検索します。

主な機能：

• query（1～255文字）が必須です
• フィルターは任意です：locale、status（draft、published）、category_id または uncategorized
• limit（1～50、デフォルトは20）と page（デフォルトは1）は任意です

kb_get_article

ヘルプセンターの記事全文と翻訳コンテンツを取得します。

主な機能：

• article_id が必須です。locale は任意です

改訂

kb_list_article_revisions

記事の改訂履歴の概要を一覧表示します。

主な機能：

• article_id が必須です。locale、limit（1～50、デフォルトは20）、page（デフォルトは1）は任意です

kb_get_article_revision

改訂履歴の全文を取得します。

主な機能：

• article_id と revision_id が必須です

kb_restore_article_revision

以前の改訂履歴から記事の翻訳を復元します。

主な機能：

• article_id と revision_id が必須です。expected_version は任意です
• 復元前に現在の翻訳を改訂履歴として保存します

改善提案（読み取り専用）

kb_list_proposals

ヘルプセンターの改善提案を一覧表示します。

主な機能：

• status（pending、needs_decision、published、dismissed、ignored）は任意です。デフォルトでは、無視された提案は除外されます
• limit（1～50、デフォルトは20）と page（デフォルトは1）は任意です

kb_get_proposal

改善提案の詳細を取得します。

主な機能：

• proposal_id が必須です

記事

kb_create_article

ヘルプセンターの記事を作成します。

主な機能：

• locale、title、Markdown形式のcontentを含むtranslationsエントリが少なくとも1つ必要です。excerptとslugは省略可能です
• excerptはメタディスクリプションとしても使用されます
• 翻訳エントリでは、任意でseo_title（検索／ソーシャル用タイトル。ページ見出しはtitleのままです）、noindex（検索エンジンから非表示にする）、canonical_url（絶対HTTP(S) URL）、og_image_url（HTTPSのソーシャルプレビュー画像）を指定できます
• category_id、position、status（draftまたはpublished）は省略可能です

kb_update_article

ヘルプセンターの記事を更新します。

主な機能：

• article_idが必須です。expected_version、category_id、position、status、translationsは省略可能です
• 翻訳エントリでは、kb_create_articleと同じSEO用の任意フィールドを指定できます。excerptはメタディスクリプションとしても使用されます
• 分類を解除するにはcategory_id: nullを送信します。現在のカテゴリを維持するには省略します
• 既存のロケールのコンテンツを編集するとリビジョンが保存されますが、SEOのみの編集では保存されません。新しいロケールにはtitleとcontentが必要です

kb_publish_article

記事をすぐに公開します。

主な機能：

• article_idが必須です。expected_versionは省略可能です

kb_unpublish_article

公開済みの記事を下書きに戻します。

主な機能：

• article_idが必須です。expected_versionは省略可能です

kb_delete_article

ヘルプセンターの記事を論理削除します。

主な機能：

• article_idが必須です。expected_versionは省略可能です

kb_delete_article_translation

記事から1つの翻訳を削除します。

主な機能：

• article_idとlocaleが必須です。expected_versionは省略可能です
• 記事には少なくとも1つの翻訳を残す必要があります

kb_reorder_articles

1つのカテゴリグループ内のすべての記事の順序を設定します。

主な機能：

• 希望する順序ですべての記事のUUIDを含むidsが必須です
• category_idは省略可能です。カテゴリなしの記事の場合は、省略するかnullを送信します

セクション

kb_create_section

ヘルプセンターのセクションを作成します。

主な機能：

• nameが必須です。slugとpositionは省略可能です

kb_update_section

ヘルプセンターのセクションを更新します。

主な機能：

• section_idが必須です。name、slug、positionは省略可能です

kb_delete_section

ヘルプセンターのセクションを削除します。

主な機能：

• section_idが必須です。そのセクションのカテゴリはセクション未割り当てになります

kb_reorder_sections

すべてのヘルプセンターセクションの表示順を設定します。

主な機能：

• 希望する順序ですべてのセクションのUUIDを含むidsが必須です

カテゴリ

kb_create_category

ヘルプセンターのカテゴリを作成します。

主な機能：

• nameが必須です。slug、position、section_idは省略可能です

kb_update_category

ヘルプセンターのカテゴリを更新します。

主な機能：

• category_idが必須です。name、slug、position、section_idは省略可能です
• セクションの割り当てを解除するにはsection_id: nullを送信します

kb_delete_category

ヘルプセンターのカテゴリを削除します。

主な機能：

• category_idが必須です。そのカテゴリの記事はカテゴリなしになります

kb_reorder_categories

すべてのヘルプセンターカテゴリの表示順を設定します。

主な機能：

• 希望する順序ですべてのカテゴリのUUIDを含むidsが必須です

ヘルプセンターの動作

• 新しい記事は、デフォルトで下書きです。作成時または更新時に status: published を設定するか、kb_publish_article を使用すると、すぐに公開されます。承認手順はありません。
• まず kb_search_articles で検索し、重複して作成するのではなく、既存の記事を更新してください。
• kb_get_article は version を返します。更新、公開、公開停止、削除、翻訳の削除、または復元を行う際は、これを expected_version として渡してください。バージョンが古い場合は、current_version を含む PRECONDITION_FAILED が返されます。再度読み込んでからやり直してください。記事のロックを待機時間内に取得できない場合、ツールは ARTICLE_LOCKED を返します。少し待ってから再試行してください。その他のエラーコードには SLUG_TAKEN があります。
• ロケールは言語で照合されます。en、en-US、en-GB はすべて英語のコンテンツに一致します。
• MCP 経由で作成された記事のソースは mcp です。各改訂には、記事を変更したユーザーと MCP クライアントが記録されます。
• ヘルプセンターの設定、ロゴや画像のアップロード、GitHub 同期、改善提案の公開または却下は、MCP 経由では利用できません。Weav アプリを使用してください。

セットアップ

認証

MCP サーバーは OAuth を使用します。接続すると、Weav によってブラウザーに同意画面が表示されます。

• 同意を完了できるのは、ワークスペースの 管理者 または オーナー のみです。
• トークンは、そのワークスペースにスコープが限定されており、mcp:use の権限が付与されます。
• 管理者は、後から Settings → Developers → MCP connections でクライアントの接続を解除できます。

API トークンやベアラートークンを使う方法はありません。OAuth を通じて接続してください。

設定例

設定ガイド 以下の例は汎用テンプレートです。設定の詳細はバージョンやプロバイダーによって異なる場合があるため、最新の設定手順については、必ずご利用の LLM プロバイダーの公式ドキュメントを参照してください。

OAuth 認証の場合：

{
  "mcpServers": {
    "weav": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.weav.com/mcp"
      ]
    }
  }
}

必須スコープ

Weav MCP サーバーは mcp:use スコープを持つトークンを発行します。このスコープは、管理者またはオーナーがワークスペースへの同意を完了したときに付与されます。

MCP-Remote のデバッグとトラブルシューティング

1. 認証の問題

# Kill existing connections
pkill -f mcp-remote

# Clear MCP auth cache
rm -rf ~/.mcp-auth

2. 接続テスト

# Test direct connection (starts the OAuth browser flow)
npx mcp-remote https://mcp.weav.com/mcp

3. アクティブな MCP 接続の表示

ps aux | grep mcp-remote | grep -v grep

エラー処理

• 認証の失敗：OAuth フローを再開してください。ワークスペースの管理者またはオーナーが同意を完了したことを確認してください。
• 401 Unauthorized：アクセストークンがない、有効期限が切れている、または Settings で接続が取り消されています。
• PRECONDITION_FAILED：expected_version を指定してから記事が変更されています。記事を再度読み込み、current_version を指定してやり直してください。
• ARTICLE_LOCKED：記事のロック取得がタイムアウトしました。少し待ってから再試行してください。
• ツールのエラー：指定した ID が、接続先のワークスペースに属していることを確認してください。

トラブルシューティングのヒント

• 設定を変更した後は、AI エージェントを再起動してください。
• URL が https://mcp.weav.com/mcp（/mcp を含む）であることを確認してください。
• ブラウザーで OAuth の同意エラーを確認してください。
• クライアントが応答しなくなった場合は、Settings → Developers → MCP connections から接続を解除し、再接続してください。