MCP Server (Claude & Cursor)

@omnistreams/mcp-server adalah Model Context Protocol server yang menjembatani OmniStream API ke klien MCP seperti Claude Desktop, Claude Code, dan Cursor. Asisten AI dapat membaca inbox dan mengirim pesan atas nama Anda lewat percakapan biasa.

Tools yang tersedia

Semua tool baca bersifat read-only; hanya send_message yang melakukan perubahan.

Setup

1. Buat API key

Buat REST API key di Developer → API Keys. Disarankan mengunci key ke IP server Anda lewat Allowed IPs.

2. Daftarkan di klien MCP

Claude Desktop / Claude Code (claude_desktop_config.json atau .mcp.json):

Code
{
  "mcpServers": {
    "omnistream": {
      "command": "npx",
      "args": ["-y", "@omnistreams/mcp-server"],
      "env": {
        "OMNISTREAM_API_KEY": "os_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "OMNISTREAM_BASE_URL": "https://api.omnistream.example"
      }
    }
  }
}

3. Coba

Minta asisten Anda, misalnya: "tampilkan percakapan WhatsApp yang masih open" atau "balas percakapan <id> dengan 'Segera saya proses'".

Konfigurasi

:::info Keamanan API key dikirim sebagai header X-API-Key dan tidak pernah di-log. Output diagnostik ditulis ke stderr agar tidak mengganggu stream JSON-RPC MCP di stdout. Semua aksi mewarisi RBAC pemilik key. :::