Skip to main content
Glama
Sign In
RBPaaS MCP Server

RBPaaS MCP Server

by mm-gtm
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

RBPaaS MCP Server

Claude Desktop から RBPaaS Operation Hub のデータにアクセスするための MCP サーバーです。

セットアップ

1. APIトークンの発行

RBPaaS Operation Hub に管理者でログインし、APIトークンを発行してもらってください。

スコープは用途に合わせて選びます。

スコープ

取れるもの

read

ダッシュボード・プロジェクト・レポート・フィードバック・シフトなど、ログインユーザーなら誰でも見られるデータ

admin

上記に加え、稼動モニタリング・活動停滞アラート・出勤率・CAレベル判定・CA報酬連絡票・最適化結果・ZoomPhone・Platform営業の提案書リンクなど IO/管理者向けのデータ

権限が足りないツールは {"error": true, "status": 403, ...} を返し、Claude がその旨を説明します。

2. Claude Desktop 設定

Claude Desktop の設定ファイルに以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rbpaas-operation-hub": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/mm-gtm/rbpaas-mcp", "rbpaas-mcp"],
      "env": {
        "RBPAAS_API_URL": "https://your-api.run.app/api",
        "RBPAAS_API_TOKEN": "roh_xxxxx..."
      }
    }
  }
}

RBPAAS_API_URL と RBPAAS_API_TOKEN を実際の値に置き換えてください。

3. 前提条件

uv がインストールされている必要があります。

# macOS
brew install uv

Related MCP server: observer-launch-mcp

使えるツール

すべて読み取り専用です（データを書き換えるツールはありません）。Claude Desktop のチャットで自然に質問するだけで、適切なツールが呼ばれます。

領域

ツール

質問例

事業・KPI

get_business_overviewget_business_metricsget_project_kpisget_toss_detailsget_project_efficiencyget_resource_utilizationget_supply_demand

「今月の事業概況は？」「今年の月次売上推移」

活動データ

get_project_activityget_daily_activityget_depot_data

「○○PJの今月の活動実績」

個人KPI

get_member_kpisget_member_daily_kpisget_individual_kpiget_sub_project_kpi

「○○PJのメンバー別KPIは？」

プロジェクト

get_project_listget_project_detailget_project_monthly_summaryget_project_monthly_targetget_project_target_change_logsget_project_groupsget_project_group_detailget_project_aggregatesget_resource_simulation_base

「9月の月次目標と実績の一覧」

契約・財務

get_projects_with_dealsget_true_os_dealsget_deals_by_projectsget_project_financialsget_contracted_amountsget_target_alignment

「9月に赤字のPJはどこ？」

レポート

get_reportsget_report_detailget_daily_reportsget_daily_report_detailget_voc_reportsget_voc_report_detailget_penetration_dimensionsget_penetration

「○○PJの直近の週次レポートを要約して」

顧客フィードバック

get_customer_feedbacksget_overdue_feedbacksget_customer_feedback_detail

「期限超過のフィードバックある？」

稼動・勤怠

get_work_monitorget_ca_activity_gridget_activity_stall_alertsget_attendance_rateget_monthly_contract_hoursget_work_time_summaryget_daily_work_timeget_user_work_time_historyget_daily_work_records

「今週の活動停滞アラートは？」「今月の出勤率」

シフト・アサイン

get_schedulesget_schedule_change_requestsget_schedule_deadline_infoget_schedule_deadline_extensionsget_optimization_historyget_optimization_resultget_daily_assignmentssuggest_dispatch_candidates

「来月○○PJに入れられる候補は？」

人

get_agentsget_usersget_user_detailget_experience_matrixget_experience_detail

「退職者も含めたCA一覧」

CA評価・報酬

get_ca_evaluation_summaryget_ca_evaluation_historyget_ca_evaluation_detailpreview_ca_deal_targetsget_ca_promotion_candidatesget_ca_demotion_candidatesget_ca_raise_candidatesget_ca_level_change_historyget_ca_salary_change_historyget_ca_planning_alertsget_ca_level_review_eventsget_ca_level_review_detailget_ca_compensation_sheetsget_ca_compensation_sheet_detail

「今月の昇格候補は？」「9月の報酬連絡票の明細」

ZoomPhone

get_zoom_phone_numbersget_zoom_phone_usersget_zoom_phone_historiesget_zoom_phone_sync_status

「○○PJに割り当てている番号は？」

Platform営業

get_proposal_linksget_proposal_link_detailget_form_outreach_messages

「今週発行した提案書リンクの反応」

含めていないもの（いずれも Operation Hub の画面上の業務データではないため）:

  • 本人専用の画面（マイページ・CA個人ダッシュボード・打刻・自分のシフト）: APIトークンには「本人」がいないため呼べない

  • 設定・連携の内部情報（APIトークン、システム設定、BigQuery設定、MMPアカウント紐付け、TRUE OS 紐付け候補など）

  • 他ツールと同じ中身のもの（連絡票CSV＝連絡票明細と同内容、1件だけ取るAPIなど）と、社外向けの公開提案書URL

開発者向け

ローカル実行

cd rbpaas-mcp
RBPAAS_API_URL=http://localhost:8080/api RBPAAS_API_TOKEN=roh_xxx uv run rbpaas-mcp

Operation Hub 側の API と合っているか確かめる

全ツールが叩くパスを Operation Hub の実ルート（末尾スラッシュ込み）と照合する。 FastAPI は末尾スラッシュが違うと 307 を返し、転送先で Authorization が落ちるため、ずれると 401 になる。 Operation Hub に API を足したり変えたりしたら、このリポジトリのツールも合わせて直すこと。

MCP Inspector でデバッグ

RBPAAS_API_URL=http://localhost:8080/api RBPAAS_API_TOKEN=roh_xxx npx @modelcontextprotocol/inspector uv run rbpaas-mcp

Available Tools

16 tools
get_agentsA

コールエージェント一覧を取得する。

Inputs: no named parameters.

get_business_overviewA

事業全体のKPIとアラートを取得する。

Args: period: 集計期間 (daily/weekly/monthly)。デフォルトはmonthly。

Inputs: period.

get_customer_feedbacksA

顧客フィードバック一覧を取得する。

Args: project_id: プロジェクトIDでフィルタ status: ステータスでフィルタ (open/in_progress/resolved/wont_do) category: カテゴリでフィルタ (feature_request/bug_report/inquiry/complaint/action_item) assignee_id: 担当者IDでフィルタ overdue_only: 期限超過のみ取得 (デフォルト: False)

Inputs: status, category, project_id, assignee_id, +1 more.

get_member_kpisA

メンバー別のKPIを取得する。

Args: project_name: プロジェクト名（必須） period: 集計期間 (daily/weekly/monthly)。デフォルトはmonthly。

Inputs: project_name (required), period.

get_optimization_historyB

アサイン最適化の実行履歴を取得する。

Args: target_month: 対象月でフィルタ (YYYY-MM形式) skip: スキップ件数 limit: 取得件数上限

Inputs: skip, limit, target_month.

get_optimization_resultC

最適化結果の詳細を取得する。

Args: run_id: 最適化実行ID (UUID)

Inputs: run_id (required).

get_overdue_feedbacksA

期限超過の顧客フィードバックを取得する。

Inputs: no named parameters.

get_project_detailC

プロジェクトの詳細情報を取得する。

Args: project_id: プロジェクトID (UUID)

Inputs: project_id (required).

get_project_efficiencyB

プロジェクト別の効率指標を取得する。

Args: period: 集計期間 (daily/weekly/monthly)。デフォルトはmonthly。

Inputs: period.

get_project_kpisB

プロジェクト別のKPI達成率を取得する。

Args: period: 集計期間 (daily/weekly/monthly)。デフォルトはmonthly。

Inputs: period.

get_project_listA

プロジェクト一覧を取得する。

Args: status: ステータスでフィルタ (planning/active/completed/on_hold/cancelled) is_active: アクティブなプロジェクトのみ取得するか (デフォルト: True) skip: スキップ件数 limit: 取得件数上限

Inputs: skip, limit, status, is_active.

get_projects_with_dealsA

プロジェクト一覧に TRUE OS ディール（契約金額）情報を結合して取得する。

各プロジェクトの deal フィールドに契約金額 (total_amount)、顧客名、 契約期間等が含まれる。deal が null の場合はディール未紐づけ。

Args: status: ステータスでフィルタ (planning/active/completed/on_hold/cancelled) is_active: アクティブなプロジェクトのみ取得するか (デフォルト: True) skip: スキップ件数 limit: 取得件数上限

Inputs: skip, limit, status, is_active.

get_resource_utilizationB

リソース（エージェント）の稼働率を取得する。

Inputs: no named parameters.

get_schedulesB

スケジュール一覧を取得する。

Args: start_date: 開始日 (YYYY-MM-DD形式、必須) end_date: 終了日 (YYYY-MM-DD形式、必須) user_id: ユーザーIDでフィルタ (UUID)

Inputs: end_date (required), start_date (required), user_id.

get_true_os_dealsA

TRUE OS 上の全ディール（契約）一覧を取得する。

プロジェクトとの紐づけに関係なく、TRUE OS Gateway に登録されている ディール情報を返す。契約金額・ステータス・フェーズ等を確認できる。

Args: status: ステータスでフィルタ (draft/contracted/agreed/negotiating/paid/cancelled/invoiced) product: 商品名フィルタ (デフォルト: Revenue BPaaS) phase: フェーズフィルタ (estimate/invoice/application、デフォルト: invoice)

Inputs: phase, status, product.

get_work_time_summaryB

勤務時間サマリーを取得する。

Args: year: 年 (例: 2026) month: 月 (1-12)

Inputs: year (required), month (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (e.g., project KPIs vs member KPIs, optimization history vs optimization result). However, there are near-duplicates like get_overdue_feedbacks vs get_customer_feedbacks with an overdue_only filter, and get_project_list vs get_projects_with_deals, which could cause slight ambiguity. Overall, descriptions help disambiguate.

    Naming Consistency5/5

    Every tool follows the same 'get_' + noun pattern in snake_case (e.g., get_business_overview, get_project_kpis, get_resource_utilization). No mixed conventions or irregular verbs. The naming is predictable and consistent.

    Tool Count4/5

    At 16 tools, the set is slightly above the typical 3-15 range but still reasonable for a comprehensive read-only reporting server covering projects, KPIs, feedback, scheduling, optimization, and deals. The count reflects the broad scope without being overwhelming.

    Completeness4/5

    The server covers a wide range of read operations for its domain, including lists, details, KPIs, utilization, feedback, schedules, and deals. Minor gaps exist (e.g., no individual feedback detail, no agent detail), but the current surface is sufficient for most reporting and monitoring workflows.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • ServiceTitan MCP Server

      jrhoades1
      F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Desktop to query ServiceTitan data about technician jobs and business performance via natural language, while protecting customer personal information.
      -

    • Workday MCP Server

      pranjalkumar-evonence
      F
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only access to Workday HCM data such as workers, organizations, locations, job profiles, and cost centers through MCP tools an LLM can call.
      -