English Français العربية

io.github.ictinnovations/ictpbx-mcp

السجل الرسمي البيانات وقواعدها

Read ICTPBX state: extensions, DID numbers, SIP trunks, tenants and live PBX statistics.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package ictpbx-mcp
Claude Code 
claude mcp add ictpbx-mcp -e 'ICTPBX_BASE_URL=<ICTPBX_BASE_URL>' -e 'ICTPBX_USERNAME=<ICTPBX_USERNAME>' -e 'ICTPBX_PASSWORD=<your ictpbx_password>' -e 'ICTPBX_TIMEOUT_MS=30000' -e 'ICTPBX_TLS_INSECURE=false' -- npx -y ictpbx-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ictpbx-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ictpbx-mcp@0.1.1"
            ],
            "env": {
                "ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
                "ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
                "ICTPBX_PASSWORD": "<your ictpbx_password>",
                "ICTPBX_TIMEOUT_MS": "30000",
                "ICTPBX_TLS_INSECURE": "false"
            }
        }
    }
}

متغيرات البيئة

  • ICTPBX_BASE_URL إلزامي ICTCore REST base URL of your ICTPBX server, normally ending in /api, e.g. https://your-ictpbx/api.
  • ICTPBX_USERNAME إلزامي API account email (ICTCore logs in by email).
  • ICTPBX_PASSWORD إلزامي سري Password for the account.
  • ICTPBX_TIMEOUT_MS Per request timeout in milliseconds. Defaults to 30000.
  • ICTPBX_TLS_INSECURE Skip TLS certificate verification. Only for a self-signed test server.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ictpbx-mcp
  2. Install
  3. Configure
  4. Tools
  5. How it connects
  6. About

ictpbx-mcp

A Model Context Protocol server for ICTPBX, the multi-tenant, white-label IP-PBX built on the ICTCore framework by ICT Innovations.

It lets an AI assistant read your PBX state — extensions, DID numbers, SIP trunk providers, tenants and live statistics — over the ICTCore REST API. It is read-only: it never places a call or changes configuration.

Install

npx -y ictpbx-mcp      # no install
npm install -g ictpbx-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTPBX_BASE_URLyesICTCore REST base, normally ending in /api, e.g. https://your-ictpbx/api
ICTPBX_USERNAMEyesAPI account email (ICTCore logs in by email)
ICTPBX_PASSWORDyesPassword for that account
ICTPBX_TIMEOUT_MSno30000Per-request timeout
ICTPBX_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only
Claude Desktop example
{
  "mcpServers": {
    "ictpbx": {
      "command": "npx",
      "args": ["-y", "ictpbx-mcp"],
      "env": {
        "ICTPBX_BASE_URL": "https://your-ictpbx/api",
        "ICTPBX_USERNAME": "admin@example.com",
        "ICTPBX_PASSWORD": "your-password"
      }
    }
  }
}

Tools

ToolWhat it does
ictpbx_pbx_statisticsCounts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences, gateways
ictpbx_list_extensionsSIP extensions with username, name, tenant
ictpbx_list_didsDID (inbound) numbers, active state and tenant
ictpbx_list_providersSIP trunk providers (upstream carriers)
ictpbx_list_tenantsTenants (customer organizations) on the PBX

How it connects

ICTPBX runs on ICTCore, which authenticates with a JWT from POST /authenticate (login by email) and reads it back from the Authorization: Bearer header. The server fetches the token on first use and refreshes it automatically.

About

Built by Tahir Almas at ICT Innovations — the team behind ICTPBX, ICTContact, ICTDialer, ICTFax and the ICTCore framework these products share. Learn more at ictpbx.com.

MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictpbx-mcp.

الأسئلة الشائعة

ما هو io.github.ictinnovations/ictpbx-mcp؟

Read ICTPBX state: extensions, DID numbers, SIP trunks, tenants and live PBX statistics.

كيف أثبّت io.github.ictinnovations/ictpbx-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add ictpbx-mcp -e 'ICTPBX_BASE_URL=<ICTPBX_BASE_URL>' -e 'ICTPBX_USERNAME=<ICTPBX_USERNAME>' -e 'ICTPBX_PASSWORD=<your ictpbx_password>' -e 'ICTPBX_TIMEOUT_MS=30000' -e 'ICTPBX_TLS_INSECURE=false' -- npx -y ictpbx-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ictinnovations/ictpbx-mcp إلى مفتاح API؟

نعم. يتطلب ICTPBX_BASE_URL, ICTPBX_USERNAME, ICTPBX_PASSWORD، وتضبطها في إعداداته.

هل io.github.ictinnovations/ictpbx-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ictinnovations/ictpbx-mcp؟

ينشره ictinnovations. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.