Instalasi MCP Didit: Claude, Cursor, VS Code, Windsurf

Pilih klien Anda di bawah ini. Server yang di-hosting (https://mcp.didit.me/mcp) tidak memerlukan kunci API. Saat pertama kali terhubung, klien Anda akan membuka browser. Klik Masuk dengan Didit, lalu setujui izinnya.

Menggunakan Claude? Halaman Hubungkan Claude berisi tautan konektor satu klik yang membuka dialog Add custom connector dengan nama dan URL sudah terisi, sehingga Anda hanya perlu mengonfirmasi dan masuk.

Klien yang belum mendukung MCP remote/HTTP (Windsurf, Zed) terhubung melalui bridge mcp-remote, yang meneruskan stdio ke URL server yang di-hosting dan menangani handshake OAuth untuk Anda.

Server yang di-hosting (direkomendasikan)

Tambahkan server dengan CLI, lalu mulai proses masuk:

claude mcp add --transport http didit https://mcp.didit.me/mcp

Jalankan Claude Code dan jalankan perintah /mcp. Browser akan terbuka untuk Masuk dengan Didit. Setelah Anda menyetujui, alat didit tersedia.

Web: klik Add Didit to Claude → lalu konfirmasi dialog yang sudah terisi otomatis.Desktop: Settings → Connectors → Add custom connector, beri nama Didit, lalu atur URL menjadi:

https://mcp.didit.me/mcp

Klik Hubungkan dan selesaikan proses Masuk dengan Didit di browser. Alat Didit kemudian muncul di menu alat di chat.

Tambahkan ke ~/.cursor/mcp.json (global) atau .cursor/mcp.json (per proyek):

{
  "mcpServers": {
    "didit": {
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

Atau gunakan Settings → Tools & Integrations → New MCP Server. Cursor mendaftarkan dirinya ke Didit melalui Dynamic Client Registration dan membuka browser untuk masuk saat pertama kali digunakan.

Dengan mode agent GitHub Copilot, tambahkan .vscode/mcp.json:

{
  "servers": {
    "didit": {
      "type": "http",
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

Atau jalankan MCP: Add Server dari command palette lalu pilih HTTP. Masuk saat diminta. Arahkan VS Code ke URL /mcp lengkap, karena server mempublikasikan metadata resource OAuth untuk path tersebut.

Windsurf terhubung melalui bridge mcp-remote. Tambahkan ke ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "didit": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
    }
  }
}

Buka Settings → Cascade → MCP Servers → Manage untuk memastikan server sudah dimuat, lalu masuk melalui browser.

Tambahkan server konteks di settings.json Zed:

{
  "context_servers": {
    "didit": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
    }
  }
}

Zed menjalankan bridge dan membuka browser untuk Masuk dengan Didit.

Klien apa pun yang mengimplementasikan MCP melalui Streamable HTTP dengan OAuth 2.1 dapat terhubung langsung ke https://mcp.didit.me/mcp. Klien menemukan server otorisasi dari https://mcp.didit.me/.well-known/oauth-protected-resource/mcp, mendaftarkan dirinya dengan Dynamic Client Registration, lalu menjalankan alur PKCE. Server hanya menerima POST pada /mcp. GET dan DELETE merespons dengan 405, karena server bersifat stateless dan tidak menyimpan stream yang dimulai dari server.Klien yang hanya mendukung stdio dapat menggunakan bridge mcp-remote yang sama seperti Windsurf dan Zed:

npx -y mcp-remote@latest https://mcp.didit.me/mcp

Untuk mencoba server tanpa klien, MCP Inspector terhubung ke URL yang sama dan memandu Anda melalui proses masuk.

Tidak ada kunci API di konfigurasi. Server yang di-hosting mengautentikasi Anda di browser dan bertindak atas nama Anda, mencakup setiap organisasi tempat Anda tergabung, dengan izin sesuai peran Anda. Lihat Autentikasi.

Server yang di-hosting merespons GET https://mcp.didit.me/healthz dengan versinya.

Verifikasi koneksi Anda

Setelah Anda masuk, tanyakan kepada klien Anda:

Use the Didit MCP server to call didit_context_get and list my organizations and applications.

Agen seharusnya memanggil didit_context_get dan menampilkan organisasi Anda beserta aplikasinya. Jika klien menyatakan tidak memiliki alat Didit, berarti server belum terhubung atau proses masuk belum selesai. Lihat Pemecahan Masalah.

Hosting mandiri

Server yang di-hosting dibangun dari repositori open-source github.com/didit-protocol/mcp (MIT). Setiap rilis juga dipublikasikan ke npm sebagai @didit-protocol/mcp-server, sehingga Anda dapat langsung menjalankan server stdio dari npm atau membangun salah satu titik masuk dari clone. Satu basis kode menyediakan dua titik masuk:

Titik masuk	Mode	Transport	Autentikasi
`dist/http.js`	Hosted	Streamable HTTP pada `MCP_PORT` (default 3000), `POST /mcp`, `GET /healthz`	OAuth 2.1 Bearer, divalidasi melalui introspeksi token
`dist/index.js`	stdio (headless)	MCP stdio	Token akses pengguna di `DIDIT_ACCESS_TOKEN`

Kedua mode bertindak sebagai pengguna Didit. Tidak ada mode kunci API aplikasi.

Kloning dan build

git clone https://github.com/didit-protocol/mcp.git && cd mcp
npm install && npm run build

Atau bangun container: docker build -t didit-mcp .. Image menjalankan dist/http.js sebagai pengguna non-root, membuka port 3000, dan memiliki pemeriksaan status pada /healthz.

Jalankan server HTTP (OAuth)

Salin .env.example ke .env, isi nilai untuk mode hosted, lalu jalankan:

node dist/http.js
# or
docker run -p 3000:3000 --env-file .env didit-mcp

Server ini hanya berfungsi sebagai server sumber daya OAuth. Server memerlukan MCP_RESOURCE_URI yang diisi dengan URL publik lengkap dari transport (misalnya https://mcp.example.com/mcp, bukan hanya origin-nya) serta kredensial yang digunakan untuk introspeksi token (MCP_OAUTH_CLIENT_ID, MCP_OAUTH_CLIENT_SECRET) terhadap server otorisasi Didit. Daftar lengkap variabel ada di Lanjutan → hosting mandiri.

Atau jalankan melalui stdio (headless)

Untuk agen lokal yang tidak dapat menjalankan alur OAuth, jalankan paket yang sudah dipublikasikan (tanpa perlu clone) dan berikan token akses pengguna di environment:

DIDIT_ACCESS_TOKEN=<user-access-token> npx -y @didit-protocol/mcp-server

Dari clone, DIDIT_ACCESS_TOKEN=<user-access-token> node dist/index.js melakukan hal yang sama. Tanpa token, agen dapat masuk dengan didit_account_login, lalu didit_account_verify_2fa jika akun memiliki autentikasi dua faktor.Opsional, MCP_DEFAULT_ORG dan MCP_DEFAULT_APP mengunci cakupan untuk penyiapan single-tenant. Daftarkan di Claude Code dengan:

claude mcp add didit-local -e DIDIT_ACCESS_TOKEN=<user-access-token> -- npx -y @didit-protocol/mcp-server

Atau di mcp.json Cursor:

{
  "mcpServers": {
    "didit-local": {
      "command": "npx",
      "args": ["-y", "@didit-protocol/mcp-server"],
      "env": { "DIDIT_ACCESS_TOKEN": "<user-access-token>" }
    }
  }
}

Server stdio open-source tidak menyertakan alat Travel Rule, marketplace, jaringan penipuan, dan alat token SDK untuk transaksi milik server hosted, juga alat kepatuhan selain alat untuk membangun alur kerja. Server ini menambahkan didit_org_top_up, didit_org_reveal_application_api_key, dan lima alat penyiapan akun (didit_account_register, didit_account_verify_email, didit_account_resend_otp, didit_account_login, didit_account_verify_2fa) yang menerima kredensial sebagai argumen, sehingga alat tersebut tidak pernah tersedia di konektor jarak jauh. Alat yang menerima file juga menerima argumen *_path di stdio, karena server berbagi sistem file dengan Anda.

Panduan

Autentikasi

Model Context Protocol (MCP)

SDK Web

SDK Native

SDK Server

Integrasi

Instalasi MCP Didit: Claude, Cursor, VS Code, Windsurf

Server yang di-hosting (direkomendasikan)

Verifikasi koneksi Anda

Hosting mandiri

Langkah selanjutnya

Autentikasi

Referensi tool

​Server yang di-hosting (direkomendasikan)

​Verifikasi koneksi Anda

​Hosting mandiri

​Langkah selanjutnya

Autentikasi

Referensi tool

Server yang di-hosting (direkomendasikan)

Verifikasi koneksi Anda

Hosting mandiri

Langkah selanjutnya