Menghubungkan klien MCP lain

Selain Claude dan ChatGPT, setiap klien MCP yang mendukung server jarak jauh lewat HTTP dan masuk dengan OAuth bisa dipakai – misalnya IDE seperti Cursor, atau MCP Inspector untuk pengujian. Artikel ini ditujukan bagi siapa pun yang menyiapkan klien seperti itu sendiri atau membangun integrasi sendiri.

#Fakta utama

URL server

https://dock.at-harbor.com/mcp

Transport

Streamable HTTP, stateless. Setiap permintaan adalah POST dengan pesan JSON-RPC (atau batch), dan respons kembali sebagai JSON. Tidak ada session ID dan tidak ada stream server.

Versi protokol

2025-11-25, 2025-06-18, dan 2025-03-26

Metode

initialize, ping, tools/list, dan tools/call. Server tidak menawarkan resources atau prompts.

Masuk

OAuth 2.1 dengan PKCE (S256). Tanpa token, server merespons dengan 401 dan menunjuk ke metadatanya di header WWW-Authenticate.

#Menyiapkan klien

1. Di klien Anda, tambahkan server MCP jarak jauh (sering disebut “Remote”, “HTTP”, atau “Streamable HTTP”)
2. Masukkan https://dock.at-harbor.com/mcp sebagai URL
3. Biarkan client ID dan secret kosong – klien mendaftarkan dirinya sendiri
4. Mulai koneksi; halaman masuk terbuka di browser Anda, diikuti halaman persetujuan LinkHarbor
5. Pilih workspace dan izin lalu klik “Izinkan”

Nama pengaturannya berbeda dari program ke program. Di MCP Inspector, misalnya, Anda memilih transport “Streamable HTTP”.

#Alur OAuth secara detail

1. Klien memanggil server MCP tanpa token dan mendapat 401 dengan petunjuk ke metadata resource
2. Klien membaca metadata server otorisasi (endpoint, metode yang didukung, izin)
3. Klien mendaftarkan dirinya: lewat Dynamic Client Registration atau dengan dokumen metadata klien di URL https
4. Klien membuka browser dengan permintaan otorisasi, termasuk PKCE dan resource=https://dock.at-harbor.com/mcp
5. Anda masuk dan memutuskan di halaman persetujuan
6. Klien menukar kode dengan access token dan refresh token

Jika klien tidak meminta izin apa pun, semua izin diminta; Anda tetap bisa mempersempitnya di halaman persetujuan. Jika refresh token yang sudah diganti dipakai lagi, LinkHarbor mengakhiri seluruh koneksi demi keamanan.

#Aturan untuk alamat pengalihan

• Alamat https
• http hanya untuk alamat loopback di komputer Anda sendiri (untuk klien desktop dan IDE)
• Skema aplikasi kustom dalam notasi domain terbalik
• Paling banyak 10 alamat per klien, tanpa fragmen

Jika sebuah aplikasi mengirim alamat yang tidak terdaftar untuknya, LinkHarbor menghentikannya: “Aplikasi mengirim alamat kembali yang tidak terdaftar untuknya. Permintaan dihentikan.”

#Alamat discovery untuk developer

#Aplikasi yang tidak dikenal

Aplikasi yang semua alamat pengalihannya berada di claude.ai, claude.com, chatgpt.com, atau openai.com dianggap dikenal. Program di komputer Anda sendiri yang kembali lewat localhost – seperti Claude Code, Codex, dan IDE – menampilkan catatan “LinkHarbor tidak mengenal aplikasi ini. Aplikasi ini berjalan di komputer Anda sendiri. Lanjutkan hanya jika Anda baru saja menjalankannya sendiri.” di halaman persetujuan, dan di bagian bawah “Setelah memilih, Anda kembali ke aplikasi di komputer Anda.” Aplikasi web lain yang tidak dikenal menampilkan “LinkHarbor tidak mengenal aplikasi ini. Lanjutkan hanya jika Anda sendiri yang memulainya dan memercayai …” dengan alamatnya di tempat titik-titik. Keduanya normal jika Anda baru saja menyiapkan klien sendiri. Logo hanya muncul jika aplikasi mengirimkannya. Jika bukan Anda yang memulai proses masuk, klik “Tolak”.