Outreach

@mindstone/mcp-server-outreach

Outreach のセールスエンゲージメント向け MCP サーバー — Outreach API を通じて、見込み客、シーケンス、アカウント、タスク、メール配信を扱います。

ワンクリックインストール

ボタンをクリックすると、ホストから次の値を入力するよう求められます：OUTREACH_CLIENT_ID、OUTREACH_CLIENT_SECRET、OUTREACH_ACCESS_TOKEN、OUTREACH_CONFIG_DIR、OUTREACH_OAUTH_PORT。

{
  "mcpServers": {
    "Outreach": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-outreach"
      ],
      "env": {
        "OUTREACH_CLIENT_ID": "",
        "OUTREACH_CLIENT_SECRET": "",
        "OUTREACH_ACCESS_TOKEN": "",
        "OUTREACH_CONFIG_DIR": "~/.mcp/outreach",
        "OUTREACH_OAUTH_PORT": "0"
      }
    }
  }
}

ステータス

• バージョン： 0.2.1 · npm
• 認証： OAuth（ローカルの 127.0.0.1 コールバック）(OUTREACH_CLIENT_SECRET)
• ツール： 22（見込み客、シーケンス、アカウント、タスク、通話、メールボックス）
• サーフェス： cloud-api
• 機械可読： STATUS.json

インストール

npx -y @mindstone/mcp-server-outreach

設定

OAuth モード（推奨）

スタンドアロンの OAuth 認証を使用するには、次の環境変数を設定します。

OUTREACH_CLIENT_ID=your_client_id
OUTREACH_CLIENT_SECRET=your_client_secret

次に、outreach_connect_account ツールを呼び出して OAuth フローを開始します。

手動トークンモード

静的なアクセストークンをお持ちの場合：

OUTREACH_ACCESS_TOKEN=your_access_token

オプション設定

OUTREACH_CONFIG_DIR=~/.mcp/outreach    # Custom config directory (default: ~/.mcp/outreach)
OUTREACH_OAUTH_PORT=0                   # OAuth callback port (default: OS-assigned)
OUTREACH_OAUTH_SCOPES="prospects.all sequences.all sequenceStates.all sequenceSteps.read sequenceTemplates.read templates.read accounts.all users.read tasks.all mailings.read calls.read mailboxes.read"

上記の OUTREACH_OAUTH_SCOPES の値は組み込みのデフォルトで、このコネクターに付属するすべてのツールを利用できます。これらのスコープが追加される前にアカウントを接続した場合、またはこの変数を上書きした場合は、新しいトークンに反映させるため、outreach_connect_account を再実行してください。

利用可能なツール（22）

アカウント管理

• outreach_connect_account — OAuth で Outreach アカウントを接続します
• outreach_list_connected_accounts — 接続済みアカウントと認証ステータスを一覧表示します
• outreach_disconnect_account — アカウントを切断し、認証情報を削除します

見込み客

• outreach_search_prospects — 名前、メールアドレス、会社、タグで見込み客を検索します
• outreach_get_prospect — ID で見込み客の詳細情報を取得します
• outreach_create_prospect — 新しい見込み客を作成します（custom_fields を custom1..custom35 にマッピングできます）
• outreach_update_prospect — 既存の見込み客を更新します（custom_fields に対応）

シーケンス

• outreach_list_sequences — フィルターを指定してシーケンスを一覧表示する
• outreach_get_sequence — ID を指定してシーケンスの詳細を取得する
• outreach_list_sequence_steps — シーケンスのステップを一覧表示する（種類、間隔、順序、テンプレートへのリンク）
• outreach_get_sequence_template — シーケンステンプレートのメール件名と本文を読み取る
• outreach_add_prospect_to_sequence — 見込み客をシーケンスに登録する
• outreach_remove_prospect_from_sequence — 見込み客の登録を一時停止または終了する

アカウント（企業）

• outreach_list_accounts — 企業アカウントを一覧表示する
• outreach_get_account — ID を指定して企業アカウントの詳細を取得する

タスク

• outreach_list_tasks — ステータスと見込み客のフィルターを指定してタスクを一覧表示する
• outreach_create_task — タスクを作成する（メモ、期限、見込み客、担当者）
• outreach_complete_task — タスクを完了としてマークする

メール送信

• outreach_list_mailings — 送信済みメールを配信状況とともに一覧表示する

通話

• outreach_list_calls — 通話を結果、メモ、処理内容へのリンクとともに一覧表示する

メールボックス

• outreach_list_mailboxes — 接続済みの送信者メールボックスを一覧表示する（登録時に mailbox_id を設定）

ユーザー

• outreach_list_users — Outreach チームのメンバーを一覧表示する

認証モード

このコネクターは 4 つの認証モードに対応しており、起動時に一度だけ検出されます。

優先順位：bridge > standalone_oauth > manual_token > unconfigured

入力と状態の仕様

• リソース ID は数値である必要があります。 Outreach のリソース ID（id、prospect_id、sequence_id、account_id、mailbox_id、user_id、owner_id）を受け取るツールのすべてのパラメーターは、数字のみ（/^\d+$/）を受け付けます。数値以外の値は、API リクエストを行う前に VALIDATION_ERROR で拒否されます。Outreach ID は常に数値のため、それ以外の値は実際に検索できる値ではなく、不正な値を示します。
• outreach_remove_prospect_from_sequence は現在有効な登録に対して動作します。 登録後にシーケンスを完了し、再登録した見込み客には、シーケンス状態のレコードが複数存在します。このツールは、最初に返されたレコードではなく、未完了の「有効な」レコードを対象にします。見込み客とシーケンスの組み合わせに対して有効な状態が複数存在する場合、ツールは安全のため処理を中止し、AMBIGUOUS_STATE を返します（レコードは変更されません）。すべての状態が完了済みの場合は、NOT_FOUND を返します。

信頼できないコンテンツの取り扱い

Outreach API から返される、ユーザーが作成したすべてのテキスト（名前、メールアドレス、メール送信の件名、テンプレート本文、タスクのメモ、タグ、カスタムフィールド）は、<untrusted-content source="..."> エンベロープで囲まれます。これにより、MCP ホストとモデルは、サードパーティの CRM コンテンツを指示ではなくデータとして扱います。ベンダーが生成した構造（ID、タイムスタンプ、ライフサイクル状態）は、そのまま返されます。ベンダーのエラーテキスト（API エラーの詳細、JSON 以外のエラーボディ、OAuth トークン交換の失敗）は 500 文字に切り詰められ、エラーメッセージに含められる前に同じ形式（source="outreach:api-error"）で囲まれます。

ライセンス

FSL-1.1-MIT