Cara menghubungkan chat Claude ke proyek osFoundry kamu dengan custom connector

Setelah mengikuti langkah-langkah ini, percakapan Claude biasa di claude.ai bisa membuka Notes, knowledge base, dan Records di salah satu proyek osFoundry kamu, menjawab berdasarkan isinya, dan memposting di channel diskusi proyek itu. Dengan persetujuanmu, chat itu juga bisa mengeditnya. Kamu tetap login ke Claude seperti biasa. Di setiap panggilan tool, osFoundry yang memutuskan apa saja yang boleh disentuh chat itu, dan setiap panggilan tercatat di osFoundry pada Recent activity milik koneksi tersebut. ChatGPT terhubung dengan cara yang sama, memakai alamat server yang sama.

Siapa mengerjakan apa

	Sisi Claude	Sisi osFoundry
Login	Akun Claude kamu, tidak berubah	Akun osFoundry kamu menyetujui koneksi sekali, untuk satu workspace
Yang menjalankan model	Claude, di chat yang sudah kamu pakai	Tidak ada. Di jalur ini tidak ada model dan tidak ada provider key
Tempat tool dijalankan	Claude mengirim panggilan tool	api.osfoundry.io menjalankannya dan mengecek akses lebih dulu
Yang bisa dijangkau	Apa pun yang dikembalikan server	Proyek yang kamu tambahkan koneksinya, plus channel tempat kamu mengundangnya
Persetujuan	Prompt izin tool milik Claude sendiri	Perubahan GitNest dan Room menunggu di "Needs your approval"
Tempat data tinggal	Jawaban ada di chat Claude kamu	Notes, record, dan artikel tetap di osFoundry. Item yang hanya lokal tidak pernah keluar dari perangkat

Setup

1. Buat koneksi di osFoundry

Di osFoundry, klik ikon kunci di header dan buka tab Connected. Panelnya berjudul "Connected agents" dan menampilkan workspace yang sedang kamu buka. Di bawah "Connect in three steps":

• Assistant: pilih Claude
• Display name: nama apa saja yang nanti mudah kamu kenali, misalnya Claude research
• Klik Add assistant (tambah asisten)

Koneksi baru menampilkan "Setup pending. This assistant cannot read or change anything yet." Salin Server address dengan tombol Copy di sebelahnya:

https://api.osfoundry.io/api/v1/external-mcp

Contoh: Tab Connected setelah Add assistant, dengan alamat server dan koneksi yang masih pending

2. Tambahkan ke Claude sebagai custom connector

Di Claude, buka Customize → Connectors lalu tambahkan custom connector dengan URL tersebut. Di paket Team atau Enterprise, owner organisasi menambahkannya lebih dulu di Organization settings → Connectors, lalu setiap anggota menghubungkan sendiri. Langkah-langkah dari Anthropic untuk remote MCP connector ada di panduan custom connector Claude.

Saat kamu klik Connect, Claude menemukan halaman login osFoundry dengan sendirinya. Kamu tidak perlu menempelkan client ID atau key.

3. Setujui satu workspace

Browser kamu akan membuka https://osfoundry.io/external-assistant-authorize, halaman berjudul "Connect an agent". Halaman ini menampilkan client asisten dan host tujuan kembalinya, lalu meminta:

• Workspace to connect: satu workspace. Workspace kedua butuh koneksi sendiri.
• Requested capabilities, dalam bahasa sederhana: "Read supported resources in projects you add", "Change supported resources where you have edit access", "Run sessions where you grant a runner role".
• Connection: pilih "Use pending: Claude research" supaya tersambung ke koneksi dari langkah 1, atau biarkan "Create a new connection".
• Centang "I approve connecting this assistant to ", lalu Connect.

Kamu akan dikembalikan ke Claude. Koneksinya sudah aktif tapi belum bisa melihat apa pun. Koneksi baru dimulai dengan nol proyek.

4. Tambahkan ke proyek

Kembali ke ikon kunci → Connected, pilih koneksinya. Sekarang tertulis "Connected." Di Projects, pilih proyek lalu klik Add to project.

Contoh: Koneksi yang sudah ditambahkan ke proyek, dengan chat yang tertaut di bawahnya

Ini memberi akses ke konten tersinkron yang didukung di proyek itu: Notes, knowledge base, channel Record, Room cloud, repositori GitNest yang ditugaskan ke proyek, dan channel diskusi proyek. Konten yang kamu tambahkan ke proyek nanti juga ikut. Channel Message biasa terpisah. Gunakan Message channels → Choose a Message channel → Invite untuk setiap channel yang perlu dibaca dan dibalas oleh chat.

Bagian Tools menulis "All supported tools are on by default." Hapus centang tool yang tidak ingin kamu berikan ke koneksi ini lalu klik Save tools.

Contoh: Checklist Tools pada koneksi Claude, semuanya aktif secara default

5. Aktifkan di chat

Di percakapan Claude, buka menu + → Connectors lalu aktifkan connector osFoundry. Setelah itu, minta saja dengan bahasa biasa.

Contoh jalannya

Prompt dan jawaban di bawah adalah konten contoh dari proyek demo. Nama tool dan nama argumennya persis seperti yang diumumkan server live di tools/list. Di claude.ai, panggilan-panggilan ini muncul di bawah nama connector. Kalau kamu menambahkan URL yang sama ke Claude Code dengan nama osfoundry, tool yang sama muncul sebagai mcp__osfoundry__list_project_resources dan seterusnya.

Contoh

Kamu: Pakai osFoundry, apa saja yang masih terbuka di checklist peluncuran Q3?
      Cek KB support kalau ada yang bertentangan, lalu tandai
      record "pricing page" sebagai Ready.

Claude → list_granted_resources {}
       ← 1 proyek terhubung: "Launch Q3" (workspace)
Claude → list_project_resources {"project_id": "…", "resource_type": "note", "search": "checklist"}
       ← Note "Q3 launch checklist"
Claude → list_note_tabs {"note_id": "…"}
       ← tab: Note (teks), Sheet "Owners"
Claude → read_note_tab {"note_id": "…", "tab_id": "…"}
       ← 9 item, 3 belum dicentang
Claude → search_knowledge_base {"knowledge_base_id": "…", "query": "refund window"}
       ← artikel "Refund policy" (diperbarui 2 hari lalu)
Claude → read_record_item {"record_channel_id": "…", "item_id": "…"}
       ← "pricing page", status Draft, version …
Claude → edit_record_item {"record_channel_id": "…", "item_id": "…",
                           "values": {"status": "Ready"},
                           "expected_version": "…", "idempotency_key": "…"}
       [Claude meminta izinmu untuk panggilan tool ini → Allow]
       ← tersimpan, version baru …

Claude: Ada tiga item yang masih terbuka: tanggal embargo pers,
        terjemahan FAQ, dan baris refund di pricing page.
        Checklist menyebut 14 hari; artikel KB "Refund policy"
        menyebut 30. Record pricing page sudah saya tandai Ready.

Dua detail di transkrip itu memang disengaja. edit_record_item butuh version yang dikembalikan read_record_item, jadi record yang berubah di antara keduanya akan ditolak, bukan ditimpa. idempotency_key yang diulang mengembalikan hasil pertama, jadi panggilan yang di-retry tidak menulis dua kali.

Di mana batasnya

osFoundry tidak bisa membuka chat Claude kamu. Koneksi MCP membuat Claude bisa memanggil tool osFoundry saat Claude memutuskan perlu. osFoundry tidak punya API ke arah sebaliknya untuk menampilkan daftar, membaca, atau memulai percakapan pribadi. Tool yang menautkan chat ke proyek (link_current_chat) menerima label yang dilaporkan chat itu tentang dirinya sendiri, dan osFoundry memperlakukannya sebagai petunjuk routing, bukan identitas yang terverifikasi. Karena alasan yang sama, Claude tidak menerima notifikasi latar belakang dari osFoundry. Claude baru bertindak ketika kamu membuka percakapan dan meminta.

Data yang hanya lokal tetap lokal. Server sendiri menyatakannya di balasan initialize: "Local-only data is unavailable to cloud clients." Room lokal, sesi Graph lokal, dan konten yang tidak pernah tersinkron tidak terlihat oleh koneksi. Berbagi sesi Graph desktop adalah switch terpisah di tab yang sama, dan aplikasi desktop harus terbuka dan dalam keadaan login.

Akses dicek di setiap panggilan, bukan di setiap login. Setiap panggilan dicocokkan dengan status koneksi, workspace-nya, keanggotaan proyek saat ini, proyek tempat item itu berada saat itu, dan peranmu sendiri pada item tersebut. Pindahkan Note ke proyek lain, keluarkan proyeknya, atau klik Revoke connection, dan panggilan berikutnya akan ditolak. Edit juga mensyaratkan kamu, orang yang menyetujui koneksi, masih punya hak edit.

Sebagian penulisan berubah menjadi usulan. Pekerjaan GitNest, change set, impor file, pull request, dan instalasi aplikasi di Room melewati tool propose_…. Semuanya menunggu di tab Connected pada "Needs your approval", tempat kamu melihat repositori atau Room tujuan dan file-filenya sebelum memilih Approve atau Decline. Claude tidak pernah menerima token Git provider kamu atau nilai rahasia apa pun.

Channel Message perlu undangan. Menjadi bagian dari proyek hanya membuka channel diskusi proyek itu. Channel lain butuh Invite secara eksplisit, dan channel privat harus diundang oleh owner-nya.

Selanjutnya

Tambahkan knowledge base ke proyek yang sama, lalu ajukan ke Claude pertanyaan yang biasanya kamu jawab dari sana, misalnya "Apa kata KB kita soal refund, sertakan nama artikelnya?". search_knowledge_base mengembalikan ID artikel dan kapan terakhir diperbarui, jadi kamu bisa mengecek sumbernya. Cara knowledge base di osFoundry disusun ada di halaman knowledge base.