de en es ja ko ru zh

superoffice-mcp-server

Name: superoffice-mcp-server
Author: alihaider663

by alihaider663

Overview Schema Related Servers Score Discussions

TypeScript

Local

SuperOffice CRM Onsite — Model Context Protocol (MCP) サーバー

SuperOffice CRM Onsite 環境向けに TypeScript で構築された、本番運用対応の Model Context Protocol (MCP) サーバーです。LLM アシスタント（Claude Desktop、Antigravity IDE、Cursor、その他の MCP クライアントなど）が、標準の SuperOffice REST WebAPI エンドポイントを介して、取引先、担当者、予定、サポートチケット、カスタムエクストラテーブル（y_*）、監査ログをシームレスに照会できるようにします。

🌟 特徴

⚡ ネイティブ MCP stdio トランスポート: デスクトップおよびターミナルベースの AI クライアントと直接統合。
🏢 会社・取引先の参照: 詳細な会社情報を取得（get_contact_by_id）。
👥 担当者検索: 氏名とメールアドレスに対するファジー検索およびフィルターベース検索（search_persons）。
📅 カレンダー・予定インテリジェンス: ユーザー割り当て付きの日付範囲フィルタリング（get_recent_appointments）。
🎫 サポートチケット管理: 最近のチケットを取得し、チケットの全メタデータを閲覧（get_latest_tickets、get_ticket_by_id）。
📊 カスタムエクストラテーブルエンジン: カスタムの y_* テーブルをすべて動的に検出・照会（list_extra_tables、query_extra_table）。
🛡️ 監査・ログテーブルエクスプローラー: y_logticket、y_logactivity、システムイベントなどの監査証跡を閲覧（list_log_tables）。
🔒 Onsite 対応: 堅牢な Basic 認証、タイムアウトガード、自己署名証明書の設定可能な処理。
🛡️ グレースフルなフォールトトレランス: 多層フォールバック検索戦略（Archive Provider ➔ REST Entity API）により、クラッシュゼロ動作を保証。

🏗️ アーキテクチャ

flowchart LR
    subgraph Client["Local Workstation / MCP Client"]
        Claude["Claude Desktop / Antigravity / Cursor"]
        MCP["SuperOffice MCP Server\n(Node.js / TypeScript)"]
        Claude <-->|stdio JSON-RPC| MCP
    end

    subgraph Server["SuperOffice Onsite Environment (VM)"]
        IIS["IIS Web Server / REST WebAPI\n/api/v1/"]
        SOApp["SuperOffice CRM Core"]
        SODb[("SuperOffice Database\n(Core + y_* Extra Tables)")]

        IIS --> SOApp --> SODb
    end

    MCP <-->|HTTP(S) Basic Auth\nREST / Archive / Entities| IIS

🛠️ 利用可能な MCP ツール

ツール名	パラメータ	説明
`get_contact_by_id`	`contactId` (数値, 必須)	会社・取引先の完全なレコード（部門、法人番号、メール、電話、カテゴリ、業種）を取得。
`search_persons`	`query` (文字列, 必須)`limit` (数値, 任意, デフォルト: 25)	氏名、姓・名、またはメールアドレスで担当者を検索。複数戦略のフォールバック付き。
`get_recent_appointments`	`fromDate` (ISO 日付, 任意)`toDate` (ISO 日付, 任意)`associateId` (数値, 任意)`limit` (数値, 任意, デフォルト: 50)	日付範囲内のカレンダー予定を、タスク、場所、取引先、完了ステータスとともに取得。
`get_ticket_by_id`	`ticketId` (数値, 必須)	カテゴリ、ステータス、作成者、所有者、取引先を含む詳細なサポートチケット情報を取得。
`get_latest_tickets`	`limit` (数値, 任意, デフォルト: 10)	チケット ID の降順で最新のサポートチケットを一覧表示。
`list_extra_tables`	なし	CRM データベースに定義されているすべてのカスタムエクストラテーブル（`y_*` テーブル）を一覧表示。
`list_log_tables`	なし	専用のログ・監査テーブル（`y_logticket`、`y_logactivity`、`y_msisdn_search_log` など）を一覧表示。
`query_extra_table`	`tableName` (文字列, 必須)`fields` (文字列, 任意)`limit` (数値, 任意, デフォルト: 25)	Dynamic archive プロバイダーを介して、任意のカスタムエクストラテーブルからレコードを動的に照会。

🚀 クイックスタート

1. 前提条件

Node.js: v18.0.0 以上
SuperOffice CRM Onsite: REST WebAPI（/api/v1/）が有効な状態でインストール済み
API 権限を持つアクティブな SuperOffice ユーザーアカウント

2. クローンとビルド

# Clone the repository
git clone https://github.com/your-username/superoffice-mcp-server.git
cd superoffice-mcp-server

# Install dependencies
npm install

# Compile TypeScript to dist/
npm run build

⚙️ 設定

環境変数

変数	必須	説明	例
`SUPEROFFICE_API_URL`	必須	SuperOffice WebAPI のベース URL（末尾スラッシュなし）	`https://osl-so-iis2.ls.local/SuperOffice`
`SUPEROFFICE_USERNAME`	必須	SuperOffice ユーザー名	`admin`
`SUPEROFFICE_PASSWORD`	必須	SuperOffice ユーザーパスワード	`YourPassword123`
`NODE_TLS_REJECT_UNAUTHORIZED`	任意	自己署名または内部 CA の SSL 証明書の場合に `0` に設定	`0`
`SUPEROFFICE_TIMEOUT_MS`	任意	HTTP リクエストのタイムアウト（ミリ秒）	`30000`

🔌 クライアント設定ガイド

1. Claude Desktop

claude_desktop_config.json に次のエントリを追加します:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "superoffice": {
      "command": "node",
      "args": [
        "C:\\path\\to\\superoffice-mcp-server\\dist\\index.js"
      ],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0",
        "SUPEROFFICE_API_URL": "https://your-crm-server/SuperOffice",
        "SUPEROFFICE_USERNAME": "admin",
        "SUPEROFFICE_PASSWORD": "your-password"
      }
    }
  }
}

2. Antigravity IDE / カスタム MCP 設定（`mcp_config.json`）

{
  "mcpServers": {
    "superoffice": {
      "command": "node",
      "args": [
        "C:\\Users\\aliha\\.gemini\\antigravity-ide\\scratch\\superoffice-mcp-server\\dist\\index.js"
      ],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0",
        "SUPEROFFICE_API_URL": "https://osl-so-iis2.ls.local/SuperOffice",
        "SUPEROFFICE_USERNAME": "admin",
        "SUPEROFFICE_PASSWORD": "your-password"
      }
    }
  }
}

🧪 テストと検証

PowerShell または bash を使用して、ターミナルで直接接続をテストできます:

# Set test environment
$env:SUPEROFFICE_API_URL="https://osl-so-iis2.ls.local/SuperOffice"
$env:SUPEROFFICE_USERNAME="admin"
$env:SUPEROFFICE_PASSWORD="your-password"
$env:NODE_TLS_REJECT_UNAUTHORIZED="0"

# Run server (logs to stderr, listens on stdin)
node dist/index.js

次のように表示されるはずです:

[superoffice-mcp] Server v1.1.0 started — connected to https://osl-so-iis2.ls.local/SuperOffice

📂 プロジェクト構成

superoffice-mcp-server/
├── .github/
│   └── workflows/
│       └── ci.yml               # Automated multi-version build testing
├── src/
│   └── index.ts                 # Main MCP Server implementation (8 tools)
├── .env.example                 # Environment variables template
├── .gitignore                   # Git ignore specifications
├── LICENSE                      # MIT License
├── package.json                 # Project manifest and scripts
├── tsconfig.json                # TypeScript compiler configuration
└── README.md                    # Comprehensive documentation

🛡️ トラブルシューティング

オンプレミスサーバーが内部認証局（CA）または自己署名証明書を使用している場合、Node.js の fetch はデフォルトで中断されます。以下を確認してください:

"NODE_TLS_REJECT_UNAUTHORIZED": "0"

が MCP 設定の env セクションに含まれていること。

以下を確認してください:

ユーザーアカウントに SuperOffice Admin で REST WebAPI 権限があること。
IIS の SuperOffice WebAPI アプリケーションプールで Basic 認証が有効になっていること。

このサーバーは、SuperOffice の高機能な Archive/Dynamic および Archive/FindPerson プロバイダーを利用して表現力豊かなクエリを実行します。インストール環境のユーザーロールで特定のプロバイダーが制限されている場合、サーバーは自動的にシンプルな REST エンティティエンドポイントへグレースフルにフォールバックします。

📜 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

This server cannot be installed

license - not tested

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Stellary Project Management MCP Server
Connect AI assistants to Stellary projects, boards, documents, and governed agent workflows.
mcp
Give AI agents access to form submissions — read, search, update, and process file attachments.
kesslerio-attio-mcp-server
Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alihaider663/superoffice-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server