mcpField
T
Teletype

Teletype

リモート
teletype.appコミュニケーション13 週間前に更新
リポジトリ公式サイト

Teletype について

TeletypeのMCPサーバーは、AIクライアントからTeletypeのサポートワークスペースを操作し、会話、顧客情報、プロジェクト設定を扱えます。読み取り専用や書き込み制御、確認、ドライランに加え、サポート向けのプロンプトとリソースを備えています。

主な機能

  1. 01会話、メッセージ、顧客プロフィールの検索
  2. 02返信の送信とメッセージ管理
  3. 03顧客情報と会話ステータスの更新
  4. 04ワークスペース情報とプロジェクト状況の確認
  5. 05読み取り専用、確認、ドライランの利用

活用シーン

  1. 01未返信の顧客会話を絞り込む
  2. 02顧客履歴を基に返信を作成
  3. 03タグ、メモ、会話の担当を整理
  4. 04チャネル、オペレーター、プロジェクト状況を確認

MCP 対応

17個のツール、サポート用プロンプト、静的リソース、リソーステンプレートを提供します。MCPクライアントはホスト型HTTPエンドポイントまたはローカルstdioで接続できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.teletype.app/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://mcp.teletype.app/mcp認証が必要
パッケージ
npmteletype-mcp-server0.1.2

ツール

詳細

English | Русский

Teletype MCP サーバー

CI npm version License: MIT MCP

アーキテクチャ | MCP クライアント | ツールのリファレンス

Teletype 用の MCP サーバーです。日々のサポート業務を支援するツールを備えています。会話の検索と閲覧、顧客プロフィールの確認、返信の送信、内部コンテキストの追加、プロジェクト状況の確認ができます。

クイックスタート

Cursor にインストール VS Code にインストール

VS Code では接続時にプロジェクトトークンの入力を求められます。Cursor の場合は、接続を開く前にアプリの環境で TELETYPE_API_TOKEN を設定してください。詳しくはクライアントガイドをご覧ください。

ホステッドサーバー(推奨)。 Teletype は MCP サーバーを https://mcp.teletype.app/mcp で実行しています。プロジェクトの Public API トークンを使って接続してください。ローカルへのインストールは不要です。Claude Code では次のように設定します。

claude mcp add --transport http teletype https://mcp.teletype.app/mcp \
  --header "X-Teletype-Api-Token: your-teletype-public-api-token"

または、このファイルを .mcp.json にマージしてください(Claude Code は環境変数から ${TELETYPE_API_TOKEN} を展開します)。

{
  "mcpServers": {
    "teletype": {
      "type": "http",
      "url": "https://mcp.teletype.app/mcp",
      "headers": { "X-Teletype-Api-Token": "${TELETYPE_API_TOKEN}" }
    }
  }
}

Claude Code と Codex では、プラグインを使うとサーバーと teletype-support スキルをまとめてインストールできます。Claude Code、Codex、Cursor 用プラグインをご覧ください。

ローカルで実行する。 macOS または Windows の Claude Desktop ユーザーは、プロジェクトのリリースから .mcpb ファイルをダウンロードして開き、表示されたら Teletype Public API トークンを入力できます。ソースから実行するには、npm ci && npm run build を実行し、環境に TELETYPE_API_TOKEN を設定したうえで、MCP クライアントの接続先を node /absolute/path/to/dist/index.js --stdio にしてください。

その他のクライアントでは、Node.js 20.19+、22.13+、または 24.x と Teletype Public API トークンを使用してください。Claude Desktop の claude_desktop_config.json に、このサーバーを手動で追加することもできます。

{
  "mcpServers": {
    "teletype": {
      "command": "npx",
      "args": ["-y", "teletype-mcp-server", "--stdio"],
      "env": { "TELETYPE_API_TOKEN": "your-teletype-public-api-token" }
    }
  }
}

クライアントを再起動し、Teletype のツール一覧を表示するよう依頼してください。このサーバーは、2025 年の initialize ハンドシェイクと MCP 2026-07-28 に対応しています。Teletype に接続せずに、ローカルのセットアップを確認できます。

TELETYPE_API_TOKEN=your-token npx -y teletype-mcp-server doctor --stdio

Cursor、Zed、その他の MCP クライアントでは、同じコマンド、引数、環境変数を使用してください。

Cursor、Copilot を搭載した VS Code、Codex、Claude Code、OpenCode、Antigravity CLI、その他の対応クライアントについては、MCP クライアントをご覧ください。ホステッド HTTP 接続とローカル stdio 接続の例を掲載しています。OpenAI 互換エンドポイントは任意で、eval:model でのみ使用されます。

Claude Code と Codex には、サーバー、teletype-support スキル、およびサポート用スラッシュコマンドをまとめてインストールするプラグインがあります。Claude Code、Codex、Cursor 用プラグインをご覧ください。

ツール

17 個のツールは、conversations、messaging、admin、meta のツールセットに分類されています。すべて登録する(デフォルト)、--toolsets で選択したツールセットにサーバーを制限する、または --read-only で読み取り専用で実行できます。ツールリファレンスには、すべてのパラメーターが記載されています。

  • find_conversations:ステータス、チャネル、チャネルタイプ(channel_type)、顧客、タグ、オペレーター、カテゴリ、検索クエリ、ページネーション(page)で会話を検索します。
  • list_clients:ページネーションを使って顧客を一覧表示するか、データを変更せずに電話番号で顧客を検索します。
  • find_messages:プロジェクトのメッセージを一覧表示するか、古いメッセージのテキストをページごとに確認します。has_more が true の間、続けてください。
  • lookup_client_profile:カスタムフィールド、メモ、最近の会話を含む顧客プロフィールを返します。
  • read_conversation_thread:デフォルトではデータを変更せずに、メッセージとリンクを読み取ります。mark_seen: true を指定すると会話を既読にし、confirm: true が必要です。include_sessions: true を指定するとセッション履歴が追加され、session_id でセッションの詳細を選択できます。また、include_group_clients: true を指定するとグループチャットの参加者が追加されます。
  • read_client_history:顧客の最近の会話を、1 回の呼び出しで最大 5 件のダイアログと、それぞれの一部のメッセージ(dialogs_limit、messages_per_dialog)まで読み取ります。返信する前に、複数のダイアログからコンテキストを収集するために使用します。
  • send_reply_to_client:既存の会話に返信する、新しい会話を /channel/send-message 経由で開始する(auto_close: true に対応)、またはメッセージを送信せずに /dialog/create 経由で会話を作成する(create_dialog_only: true)ことができます。
  • create_dialog_by_phone:メッセージを送信せずに、電話番号でダイアログを作成または検索します。既存のオープンダイアログは、プロジェクトのオーナーに割り当てられる場合があります。confirm: true が必要で、dry_run に対応しています。
  • send_whatsapp_template:24 時間の時間枠外で、既存の WhatsApp Edna の会話に承認済みの WABA テンプレートを送信します。テンプレート ID はクイック返信リストではなく、プロジェクトにインポートされた WABA テンプレートから取得します。
  • manage_sent_message:オペレーターのメッセージを編集、削除、または再送信します。
  • annotate_client_record:顧客の識別情報(name、phone、email、additional_payload、force_additional_payload)、タグ、メモ、メモの削除(delete_note_id)、カスタムフィールド、またはダイアログのカテゴリを更新します。
  • resolve_conversation:会話を終了する、オペレーターに再割り当てする(または assign_operator: "auto" で自動割り当てする)、ダイアログをオープンのままにする(close: false)、またはオープンダイアログを回答済み(mark_answered: true)もしくは未回答(mark_unanswered: true)としてマークします。
  • list_workspace_metadata:チャネル(channel_type と only_active のフィルター付き)、タグ、カテゴリ、テンプレート、テンプレートフォルダー(template_directories)、オペレーターグループ、オペレーターを一覧表示します。
  • get_project_status:Teletype プロジェクトの課金状況、オペレーターの対応状況、技術的なステータスを返します。
  • manage_operator_group:グループメンバーの追加・削除(add_member、remove_member)、グループチャネルの追加・削除(add_channel、remove_channel)、スーパーバイザーロールの設定(set_supervisor)、チャネル会話の表示設定(set_channel_visibility)を行います。
  • configure_project_webhook:/project/update-public-api 経由で、Webhook の送信先 URL と有効にするイベントを設定します。
  • get_capabilities:サーバーで有効なツールマップ(プロジェクト名とドメイン、読み取り専用モード、有効なツールセット、登録済みツール)を返します。常に利用できます。

未回答の対応には、status: "unanswered" を指定して find_conversations を使用します。チャネルの一覧を取得するには、resource: "channels" を指定して list_workspace_metadata を使用します。チャネルと Public API の状態を確認するには、aspect: "technical" を指定して get_project_status を使用します。これらのフィルターを使うと、無関係なデータや、件数が制限された all の一覧を避けられます。会話を終了する際は、ユーザーが指定していない限り category を省略します。指定がある場合は、まず resource: "categories" から正確な名前を取得してください。不明なカテゴリが指定されている場合、変更が行われる前に呼び出しは停止します。 データを変更するツールには confirm: true が必要です。このフラグにより、誤って呼び出すリスクを軽減できます。認可とユーザーの同意には、引き続き MCP クライアント側で対応する必要があります。send_reply_to_client と send_whatsapp_template は dry_run: true を指定すると、送信せずに対象とメッセージをプレビューできます。create_dialog_by_phone は dry_run: true を指定すると、ダイアログを作成または割り当てずに、対象と想定される副作用をプレビューできます。ドライランでは confirm は不要です。

各ツールは outputSchema を公開します。短い content テキストには、主な結果とリンクが記載されます。完全な結果は structuredContent に含まれており、サーバーはその内容をスキーマに照らして検証します。一部の書き込みが行われた場合は、適用された操作と失敗を含むエラーが返されます。タイムアウト、キャンセル、またはスキーマエラーの後に書き込みを再試行する場合は、リモートの状態を確認してください。

Public API のレスポンスデコーダーは、追加のフィールドを受け入れます。読み取り、書き込み、ステータス報告に使用するレスポンスフィールドを検証します。必須フィールドが使用できない場合は、MCP サーバーを停止せずにツールエラーが発生します。

プロンプト

サーバーは、次のサポート用プロンプトを提供します。

  • triage-inbox:未返信の受信ダイアログを、緊急度と優先度に基づいてトリアージします。
  • draft-reply:会話履歴とトーンに沿った顧客への返信案を作成します。
  • client-summary:顧客プロフィール、過去の問題、未解決のトピックを要約します。
  • escalate-issue:エンジニアリングチームまたはシニアサポート向けの、構造化されたエスカレーション情報を作成します。
  • shift-handover:バックログキュー、チャネルの稼働状況、チームの対応可能状況を含む、シフト引き継ぎレポートを作成します。

リソースとテンプレート

静的リソース
  • teletype://project/status:現在のプロジェクト状況、チャネルの状態、残高。
  • teletype://workspace/metadata:ワークスペースのチャネル、オペレーター、グループ、タグ、カテゴリ。
  • teletype://dialogs/unanswered:直接リンク付きの、現在未返信となっている顧客ダイアログのキュー。
リソーステンプレート
  • teletype://dialogs/{dialogId}:IDで指定したダイアログの完全なメッセージ履歴。
  • teletype://clients/{clientId}:クライアント ID で指定したクライアントのプロフィール、タグ、メモ。

Claude Code、Codex、Cursor 向けプラグイン

このリポジトリには、Claude Code、Codex、Cursor 向けのマーケットプレイスが含まれています。plugin/ ディレクトリには、.claude-plugin/plugin.json と .cursor-plugin/plugin.json、ポータブルな Agent Plugins マニフェスト plugin.json と mcp.json、共通の サポートスキル、およびコマンドが含まれています。設定とデータアクセスについては、プラグインの README を参照してください。

Claude Code

このプラグインには、ホスト型 MCP サーバー(https://mcp.teletype.app/mcp。プラグインの機密設定フィールドで指定された X-Teletype-Api-Token ヘッダーを使って認証します)、サポートのワークフローと安全ルールを含む teletype-support スキル、サーバーの MCP プロンプトに対応する5つのスラッシュコマンド /triage-inbox、/draft-reply、/client-summary、/escalate-issue、/shift-handover が含まれています。

/plugin marketplace add Teletype-App/teletype-mcp-server
/plugin install teletype@teletype-mcp-server

プラグインを有効にするときは、Teletype Public API token フィールドにトークンを入力してください。この必須の機密 userConfig フィールドは、値を Claude のセキュアな認証情報ストアに保存し、HTTP ヘッダーに設定します。userConfig に対応した最新の Claude Code バージョンを使用してください。このスキルには、ツールの説明に収まらない複数ステップの手順が含まれます。たとえば、トリアージの順序、曖昧な送信の前にドライランを行うこと、クローズ前にカテゴリを検索することなどです。スラッシュコマンドを使わないサポートタスクで、このスキルが起動します。5つのワークフローは、表示に対応したクライアント向けに MCP プロンプトとしても提供されています。コマンドは、それらが表示されないセッションで使います。

Cursor

Cursor のネイティブマニフェストは、ホスト型サーバーに接続し、共通のスキルとコマンドを含みます。マーケットプレイスからインストールする場合は、Plugins → Configure で TELETYPE_API_TOKEN を設定してください。プラグインを使わずに直接接続するには、Cursor のセットアップガイドに従ってください。

Codex

Codex を起動する前に、シェルで TELETYPE_API_TOKEN をエクスポートします。同梱の stdio サーバーは、Codex プロセスからこの環境変数を引き継ぎます。

codex plugin marketplace add Teletype-App/teletype-mcp-server

次に、Codex で /plugins を実行し、teletype をインストールして、新しいセッションを開始します。このプラグインはスキルとローカルの stdio サーバーを追加します(Agent Plugins 仕様では HTTP ヘッダー内での変数展開が許可されていないため、ユーザーごとのトークンをプラグインに含めることはできません)。代わりに Codex をホストされたエンドポイントに接続するには、~/.codex/config.toml に追加します。

[mcp_servers.teletype]
url = "https://mcp.teletype.app/mcp"
env_http_headers = { "X-Teletype-Api-Token" = "TELETYPE_API_TOKEN" }

Codex はプラグインを使わずに、リポジトリ内の .agents/skills またはユーザー用の ~/.agents/skills からもスキルを読み込みます。

その他のエージェント

Skills CLI でサポートスキルをインストールします。

npx skills add Teletype-App/teletype-mcp-server --skill teletype-support

プロンプトが表示されたら、エージェントとインストール範囲を選択します。このコマンドはワークフローの手順をインストールします。クライアントガイドに従って、MCP サーバーを別途接続してください。

このスキルは、OpenCode、Cursor、Gemini CLI、GitHub Copilot、Goose などがサポートするオープンな Agent Skills 形式を使用します。npm パッケージにはスキルが含まれているため、通常のインストール後に次の操作を行います。

mkdir -p ~/.agents/skills
cp -r node_modules/teletype-mcp-server/plugin/skills/teletype-support ~/.agents/skills/

CLI の使用方法

サーバーは CLI フラグと環境変数を受け付けます。

teletype-mcp-server --help
# Options:
#   -s, --stdio       Use stdio transport
#   --http            Use Streamable HTTP transport (default)
#   -p, --port <num>  Port for HTTP transport (default: 4311)
#   --host <ip>       Host for HTTP transport (default: 127.0.0.1)
#   -v, --version     Show version
#   -h, --help        Show help

--read-only と --toolsets <names>(カンマ区切りの conversations,messaging,admin,meta)は、クライアントが接続する前に、サーバーが登録するツールを絞り込みます。get_capabilities は常に登録され、現在有効な構成を報告します。

要件とローカルインストール

  • パッケージ化された CLI には Node.js 20.19 以降、22.13 以降、または 24.x が必要です。
  • プロジェクト設定から取得した Teletype Public API トークンが必要です。

同じバージョンの Node.js で、ローカルの npm start、npm run dev、npm run eval:model スクリプトも実行できます。

npm ci
npm run build
cp .env.example .env

stdio トランスポート

ローカルの個人用 MCP クライアントには stdio を使用します。プロセスは環境変数からトークンを読み込みます。attachment_path によるファイルのアップロードは、デフォルトで無効になっています。有効にするには、ENABLE_LOCAL_UPLOADS=true を設定し、許可するディレクトリを TELETYPE_ALLOWED_FILE_ROOTS に指定します。他のローカルユーザーが書き込みできないディレクトリを使用してください。

ローカルビルドの設定:

{
  "mcpServers": {
    "teletype": {
      "command": "node",
      "args": ["/absolute/path/to/teletype-mcp-server/dist/index.js", "--stdio"],
      "env": { "TELETYPE_API_TOKEN": "..." }
    }
  }
}

ローカルで実行します。

TRANSPORT=stdio TELETYPE_API_TOKEN=... npm start

Streamable HTTP トランスポート

ホストされたサービス https://mcp.teletype.app は、このエンドポイントを使用します。以下の設定はセルフホスト用です。

/mcp エンドポイントと stdio トランスポートは、2025 年の initialize ハンドシェイクと MCP 2026-07-28 の server/discover の両方をサポートします。どちらも同じツール定義を使用します。

エンドポイント:POST /mcp。すべてのリクエストに、次のヘッダーで Teletype API トークンを送信します。

X-Teletype-Api-Token: <token>

Teletype プロジェクトトークンを Authorization で送信しないでください。リモートアクセスには HTTPS を使用してください。プロジェクトトークンを持つ人は誰でも、デプロイの制限に従って、MCP サーバー経由でそのデータにアクセスできます。

公開ホストエンドポイント https://mcp.teletype.app/mcp では OAuth は無効になっています。X-Teletype-Api-Token にプロジェクトトークンを指定して接続してください。セルフホストの場合、コードにはオプションの OAuth が含まれています。デフォルトでは無効で、別途設定して有効にします。

TRANSPORT=http HOST=127.0.0.1 PORT=4311 npm start

HTTP エンドポイント:

メソッドパス用途
GET/ロシア語と英語のランディングページ
GET/assets/*ランディングページのスクリプト、スタイル、ロゴ、フォント
POST/mcpステートレスな Streamable HTTP MCP
GET/healthzヘルスチェック

HTTP リクエストごとに独自の MCP Server とトランスポートのペアが割り当てられるため、同時に接続するテナント間でレスポンスやコンテキストが共有されることはありません。サーバーは、グローバルおよびトークンごとに同時リクエスト数を制限します。上限に達すると、Retry-After を付けて 429 を返します。HTTP トランスポートからローカルファイルを読み取ることはできません。

Docker

イメージは非特権ユーザーとして実行され、デフォルトでポート 4311 をリッスンします。

docker build -t teletype-mcp-server .
docker run --rm -p 127.0.0.1:4311:4311 \
  -e PUBLIC_BASE_URL=http://127.0.0.1:4311 \
  teletype-mcp-server

パブリックドメインを使用する場合は、PUBLIC_BASE_URL にそのオリジンを設定し、リバースプロキシで HTTPS を終端してください。

MCP クライアントが stdio 経由でコンテナーを起動する場合は、stdio ターゲットをビルドし、プライベート環境からトークンを渡してください。MCP メッセージに干渉する -t は省略し、-i を指定して stdin を開いたままにします。

docker build --target stdio -t teletype-mcp-stdio .
docker run --rm -i -e TELETYPE_API_TOKEN teletype-mcp-stdio

stdio ターゲットは同じ非特権ユーザーとして実行され、HTTP ポートを公開せず、HTTP ヘルスチェックも使用しません。書き込みツールを無効にするには、TELETYPE_MCP_READ_ONLY=true を設定してください。

設定

変数デフォルト
TRANSPORThttp
HOST / PORT127.0.0.1 / 4311
PUBLIC_BASE_URLhttp://127.0.0.1:4311
ALLOWED_ORIGINSカンマ区切りで追加するオリジン
OAUTH_ENABLEDfalse
OAUTH_DB_PATHOAuth 有効時の永続 SQLite パス
OAUTH_ENCRYPTION_KEYOAuth 有効時に必要なプライベートな 64 文字の 16 進数キー
TELETYPE_API_TOKENstdio に必須
TELETYPE_API_BASEhttps://api.teletype.app/public/api/v1
TELETYPE_PROJECT_URLteletype.app
TELETYPE_MCP_LOCALEen(ロシア語のテキストには ru)
TELETYPE_MCP_READ_ONLYtrue にすると書き込みツールの登録を解除
TELETYPE_MCP_TOOLSETS登録するツールセット(カンマ区切り)
REQUEST_TIMEOUT_MS15000
MAX_RESPONSE_BYTES5000000
MAX_UPLOAD_BYTES20000000
MAX_CONCURRENT_REQUESTS32
MAX_CONCURRENT_PER_TOKEN4
ENABLE_LOCAL_UPLOADSfalse
TELETYPE_ALLOWED_FILE_ROOTS許可するディレクトリ(カンマ区切り)

PUBLIC_BASE_URL と ALLOWED_ORIGINS の各項目は、パス、クエリ、フラグメントを含まないオリジンである必要があります。サーバーは、クライアントが Origin ヘッダーを送信するたびに値を検証します。

TELETYPE_MCP_LOCALE は、MCP の説明、ツールの説明、プロンプト、ヒント、サーバーが生成するエラーの言語を設定します。すべての HTTP クライアントを含む、サーバープロセス全体に適用されます。ロシア語のテキストを使用するには、MCP サーバーの環境で ru に設定してください。ツール名、引数名、structuredContent フィールドは変わりません。Teletype の顧客データとエラー詳細は元の言語のままです。サーバーはホスト OS や API トークンからロケールを推測しません。

トラブルシューティング

  • クライアントが接続できない場合:トークンを指定して doctor --stdio を実行し、クライアントのトランスポート設定を確認してください。
  • stdio transport requires TELETYPE_API_TOKEN:トークンをクライアントのサーバー環境に追加してください。doctor が確認するのはローカル設定のみで、トークンの有効性は確認しません。
  • クライアントのリストにツールが表示されない場合:doctor --stdio を実行して Mode と Toolsets の行を確認するか、get_capabilities を呼び出してください。--read-only と --toolsets は登録時にツールを非表示にします。
  • Teletype から HTTP 401 または 403 が返される場合:Teletype のプロジェクト設定でトークンを確認してください。
  • 書き込みがタイムアウトした、またはキャンセルされた場合:再送信する前に、会話またはプロジェクトの状態を確認してください。

開発

npm run dev
npm run dev:stdio
npm run check:fast
npm run check
npm run test:mutation
npm run mcp:smoke
npm run package:smoke
npm run bundle:mcpb
npm run mcp:conformance

mcp:smoke は、SDK クライアントを使用して、HTTP と stdio 経由で 2025 および 2026-07-28 のハンドシェイクを確認します。テストでは、HTTP トークンの分離も確認し、outputSchema に適合しないツール結果を拒否します。

package:smoke は、一時ディレクトリに npm アーカイブをインストールし、CLI、エクスポート、両方のプロトコルバージョン、評価用フィクスチャを確認します。mcp:conformance は、独立した MCP 適合性テストスイートから 5 つの短いシナリオを実行し、ローカルサーバーと偽の Teletype API を検証します。どちらのコマンドも Teletype プロジェクトには接続しません。

bundle:mcpb は artifacts/teletype-mcp-server-v<version>.mcpb を作成し、マニフェストを検証して、パッケージ化されたサーバーを MCP stdio 経由で確認します。Teletype には接続しません。

モデル互換性評価

ターミナルエージェントで評価を実行するには、オフライン評価用フィクスチャに接続します。エージェントは偽の Teletype データに対して MCP ツールを使用し、eval_grade_case を通じて、結果、初回試行、回答、安全性の各指標を個別に取得できます。モデル API エンドポイントは不要です。

評価結果には、各ターミナルクライアントにおける 21 件の完了タスクと 9 件のツール選択ケースについて、トークン数、所要時間、API 相当の推定トークンコストが記載されています。

オプションの eval:model コマンドは、OpenAI 互換のチャット補完エンドポイントを通じて同じ確認を実行します。ローカルの偽 Teletype API と MCP サーバーを起動するため、実際のプロジェクトトークンや顧客データは必要ありません。

OpenAI 互換の POST /chat/completions を提供するエンドポイントを設定します。

cp .env.eval.example .env.eval
# Set EVAL_MODEL_BASE_URL, EVAL_MODEL_NAME, and EVAL_MODEL_API_KEY if needed.
npm run eval:model > eval-report.json

ツールの説明を簡単に確認するには、npm run eval:selection > selection-report.json を実行します。設定されたモデルに 9 件の合成リクエストを送信し、最初に選ばれたツールのみを確認します。Teletype のツールは実行されません。選択が誤っている場合、または選択されなかった場合、終了コード 2 が返されます。この確認では、エージェントがタスクを完了できるかどうかは測定しません。

評価では、次の項目を確認します。

  • ツールの選択。
  • 必須引数と実行時の検証。
  • 読み取り専用シナリオで書き込み呼び出しがないこと。
  • 送信またはクローズの前に確認を行うこと。
  • 最終回答に重要な結果の事実が含まれていること。

デフォルトでは 21 件のシナリオを実行します。EVAL_CASES で対象を選択し、EVAL_THRESHOLD で合格スコアを設定します。終了コードは、合格が 0、スコアがしきい値を下回った場合が 2、設定または実行時エラーが 1 です。JSON レポートは stdout に、診断情報は stderr に出力されます。評価では、シナリオのテキストと偽の API 応答が、設定されたモデルエンドポイントに送信されます。

レポートには、結果、初回試行、回答、安全性の各率も含まれます。各シナリオは新しい偽のプロジェクトから開始します。1 回のエージェント実行中の修正は最終結果に反映されますが、初回試行の指標には影響しません。

npm run check:fast は、フォーマット、リント、型チェック、テストを実行します。npm run check では、これらに加えて Knip、カバレッジしきい値、リクエストの分離と制限に対する 100% のミューテーションスコアゲート、ビルド、Publint と Are the Types Wrong によるパッケージチェックを実行します。

npm run test:mutation は、スコアの下限を 33% とするミューテーションテスト一式を実行し、レポートを reports/mutation/ に出力します。時間がかかるため、npm run check には含まれていません。

脆弱性の報告については SECURITY.md を、貢献ガイドラインについては CONTRIBUTING.md を参照してください。このプロジェクトは MIT ライセンスを採用しています。

サポートとプライバシー

コメント

MCP は初めてですか?

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

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