本文へスキップ
SpecifyDocs

Specify MCP

提供ツール

Specify MCPサーバーが公開する検索・読み取り・探索・作成・編集ツールについて説明します。

Specify MCP は Specify エージェントと同じ作業空間・知識検索ツールを外部エージェントに提供します。利用可能なツールと入力は、クライアントの tools/list が返すスキーマに従います。

検索と読み取り

ツール用途
list_files文書やアップロードしたファイルのパスと現在のバージョンを確認します。
search_files文書本文で文字列を探します。
read_fileファイル本文を読みます。startLine、endLine で範囲を指定できます。
knowledge_search意味が関連する知識の断片を探します。
knowledge_grep索引化された資料で正確な文字列を探します。
knowledge_status知識資料の処理状態を確認します。
search_connectors接続した外部サービスで資料を検索します。

知識・コネクターツールの提供は、接続したサービスとワークスペースの状態によって異なります。

文書とキャンバス

ツール用途
create_document、write_document文書の作成や本文の保存を行います。
edit_document既存文書の指定した文字列を編集します。
list_document_history、read_document_revision文書の履歴や以前の版を読みます。
revert_document文書を以前の版に戻します。
create_canvas、read_canvas、edit_canvasキャンバスを作成、読み取り、編集します。

編集前に read_file または read_canvas で最新の内容を読んでください。書き込み時はスキーマが要求する baseRevision と位置のバージョンを渡します。競合した場合は再読込して編集します。edit_document の oldText は正確に1回だけ一致する必要があります。

フォルダーとゴミ箱

create_folder、move_entry、trash_entry、list_trash、restore_entry でフォルダーと項目を管理します。項目を削除するツールは、クライアントに破壊的な操作として通知されます。

権限と制限

読み取りは mcp:read、文書・キャンバス・構造の変更は mcp:write が必要です。書き込みにはワークスペースの役割と現在のアクセスポリシーも適用されます。MCPから除外した文書・フォルダーとその配下は外部アクセスの対象外です。

MCP はワークスペース資料の検索、読み取り、許可された編集を提供する接続です。コードの実装を進める際は、外部コーディングエージェントに文書の読み取りと実装を直接依頼してください。トークンとアクセスポリシーを参照してください。