Menggunakan MCP di Bob

Level konfigurasi

Kamu bisa mengkonfigurasi MCP server di dua level:

• Global: Disimpan di ~/.bob/mcp.json, berlaku di semua workspace
• Project: Disimpan di .bob/mcp.json di root proyekmu, memungkinkan berbagi tim melalui version control

Konfigurasi level proyek lebih diutamakan dari pengaturan global ketika ada konflik nama server.

Edit file konfigurasi

Kamu bisa mengedit file konfigurasi MCP dari menu settings:

1. Klik ikon di panel Bob.
2. Pilih tab MCP.
3. Klik tombol yang sesuai:
   • Edit Global MCP: Membuka file global ~/.bob/mcp.json
   • Edit Project MCP: Membuka file .bob/mcp.json spesifik proyek (Bob membuatnya jika belum ada)

Kedua file menggunakan format JSON dengan objek mcpServers yang berisi konfigurasi server bernama.

Temukan dan instal server

IBM Bob tidak menyertakan MCP server yang sudah terinstal. Untuk menemukan server:

• Bangun milikmu sendiri: Gunakan MCP SDK untuk membuat server kustom (lihat repository MCP GitHub)
• Community server: Jelajahi MCP server yang berkontribusi dari komunitas di ekosistem MCP

Aktifkan atau nonaktifkan MCP server

Ketika kamu menonaktifkan MCP server, Bob menghapus semua logika dan definisi terkait MCP dari system prompt-mu, mengurangi penggunaan token. Bob tidak bisa terhubung ke MCP server manapun, dan tools use_mcp_tool serta access_mcp_resource tidak tersedia. Pengaturan ini diaktifkan secara default.

Untuk mengaktifkan atau menonaktifkan MCP server:

1. Klik ikon di panel Bob.
2. Pilih tab MCP.
3. Centang atau hapus centang Use MCP Servers.

Aktifkan atau nonaktifkan pembuatan MCP server

Ketika kamu menonaktifkan pembuatan MCP server, Bob menghapus instruksi dari system prompt-mu yang digunakan Bob untuk menulis MCP server. Bob mempertahankan konteks untuk mengoperasikan MCP server yang ada, mengurangi penggunaan token. Pengaturan ini diaktifkan secara default.

Untuk mengaktifkan atau menonaktifkan pembuatan MCP server:

1. Klik ikon di panel Bob.
2. Pilih tab MCP.
3. Centang atau hapus centang Enable MCP Server Creation.

Aktifkan atau nonaktifkan MCP tool individual

Kamu bisa mengaktifkan atau menonaktifkan tools tertentu dalam MCP server untuk mengontrol kemampuan mana yang bisa diakses Bob. Ini memberikan kontrol granular atas fungsionalitas MCP dan membantu mengurangi penggunaan context window dengan mengecualikan definisi tool yang tidak digunakan.

Untuk mengelola tools individual:

1. Klik ikon di panel Bob.
2. Pilih tab MCP.
3. Temukan MCP server di daftar.
4. Perluas server untuk melihat tools yang tersedia.
5. Toggle tools individual on atau off sesuai kebutuhan.

Menonaktifkan tools yang tidak digunakan mengurangi jumlah konteks yang dikonsumsi oleh definisi tool, memungkinkan lebih banyak ruang untuk kode dan riwayat percakapanmu.

Tipe transport

MCP mendukung berbagai tipe transport untuk komunikasi server. Pilih transport berdasarkan di mana server-mu berjalan dan bagaimana kamu ingin men-deploy-nya. Untuk informasi detail tentang semua tipe transport, lihat MCP server transports.

STDIO transport

Gunakan STDIO transport untuk server lokal yang berjalan di mesinmu.

Manfaat:

• Latensi lebih rendah (tidak ada overhead jaringan)
• Keamanan lebih baik (tidak ada eksposur jaringan)
• Setup lebih sederhana (tidak perlu HTTP server)

Parameter konfigurasi:

Contoh:

{
  "mcpServers": {
    "local-server": {
      "command": "node",
      "args": ["server.js"],
      "cwd": "/path/to/project/root",
      "env": {
        "API_KEY": "your_api_key"
      },
      "alwaysAllow": ["tool1", "tool2"],
      "disabled": false
    }
  }
}

Untuk informasi lebih detail, lihat STDIO transport.

Streamable HTTP transport

Gunakan Streamable HTTP transport untuk server remote yang diakses melalui HTTP/HTTPS. Ini adalah standar modern untuk implementasi server remote baru.

Manfaat:

• Bisa di-host di mesin yang berbeda
• Mendukung beberapa koneksi klien
• Memungkinkan deployment terpusat
• Mendukung request-response sederhana dan streaming

Parameter konfigurasi:

Contoh:

{
  "mcpServers": {
    "remote-server": {
      "type": "streamable-http",
      "url": "https://your-server-url.com/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      },
      "alwaysAllow": ["tool3"],
      "disabled": false
    }
  }
}

Untuk informasi lebih detail, lihat Streamable HTTP transport.

SSE transport (legacy)

Gunakan SSE transport untuk server remote yang diakses melalui HTTP/HTTPS. Untuk server remote baru, gunakan Streamable HTTP transport sebagai gantinya.

Manfaat:

• Bisa di-host di mesin yang berbeda
• Mendukung beberapa koneksi klien
• Memungkinkan deployment terpusat

Parameter konfigurasi:

Contoh:

{
  "mcpServers": {
    "remote-server": {
      "url": "https://your-server-url.com/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      },
      "alwaysAllow": ["tool3"],
      "disabled": false
    }
  }
}

Buat MCP server dengan Bob

Kamu bisa meminta Bob membangun custom MCP server untuk kemampuan spesifik yang kamu butuhkan.

Prasyarat: Aktifkan pengaturan Enable MCP Server Creation.

Untuk membuat server:

1. Minta tool atau kemampuan dari Bob. Misalnya:

   • "Create an MCP tool that gets the current Bitcoin price"
   • "Build an MCP server to interact with the GitHub Gist API"

2. Bob akan:

   • Scaffold proyek server (biasanya TypeScript) di direktori MCP default
   • Mengimplementasikan tool yang diminta dengan panggilan API yang diperlukan
   • Memintamu API key atau credential jika diperlukan
   • Menambahkan konfigurasi server ke file pengaturanmu
   • Terhubung ke server baru secara otomatis

Untuk informasi lebih lanjut tentang mekanisme tool, lihat Pahami tools Bob.

Kelola server individual

Untuk mengakses pengaturan server:

1. Klik ikon di panel Bob.
2. Pilih tab MCP.
3. Temukan server di daftar.

Tindakan yang tersedia:

• Delete: Klik dan konfirmasi penghapusan
• Restart: Klik untuk me-restart server
• Enable/Disable: Toggle server on atau off menggunakan power toggle
• Network timeout: Set response timeout (30 detik hingga 5 menit, default 1 menit)
• Manage tools: Perluas server untuk mengaktifkan atau menonaktifkan tools individual

Auto-approve tools

Auto-approval MCP tool dinonaktifkan secara default dan bekerja per-tool:

1. Aktifkan opsi global "Use MCP servers" di Auto-approving actions.
2. Di pengaturan MCP server, temukan tool.
3. Centang Always allow di sebelah nama tool.

Pengaturan global lebih diutamakan — jika dinonaktifkan, tidak ada MCP tool yang auto-approve.

Gunakan MCP tools secara efektif

Setelah mengkonfigurasi MCP server, Bob secara otomatis mendeteksi tools yang tersedia. Penggunaan yang efektif bergantung pada definisi tool yang jelas.

Workflow

1. Ketik permintaanmu di antarmuka chat Bob
2. Bob menganalisis permintaanmu dan MCP tool yang tersedia
3. Bob mengusulkan penggunaan tool; kamu menyetujui (kecuali auto-approved)

Tulis deskripsi tool yang efektif

Kemampuan Bob untuk memilih dan menggunakan tools dengan benar bergantung pada kualitas deskripsi. Ikuti panduan ini saat mendefinisikan MCP tool:

Nama tool

Gunakan nama yang deskriptif dan tidak ambigu yang menunjukkan fungsi utama.

Deskripsi tool

Berikan ringkasan komprehensif yang mencakup:

• Apa yang dilakukan tool
• Tujuan dan use case-nya
• Prasyarat atau konteks penting
• Hasil yang diharapkan

Deskripsi parameter

Untuk setiap parameter, tentukan:

• Tujuan dan tipe data yang diharapkan
• Persyaratan atau batasan format
• Contoh nilai yang valid
• Apakah opsional atau wajib

Contoh

Deskripsi buruk:

Gets data

Deskripsi bagus:

Retrieves user profile data from the API using a user ID. 
Returns JSON containing username, email, and account creation date. 
Requires valid authentication token in environment.

Panduan tambahan

Gunakan Custom rules untuk mendefinisikan pendekatan yang disukai, workflow kompleks, atau prioritas tool untuk timmu.

Pertimbangan keamanan MCP

Risiko privasi data

MCP server eksternal:

• Mungkin mengirim datamu ke penyedia eksternal atau layanan pihak ketiga
• Bisa mengekspos kode sensitif, credential, atau informasi proprietary
• Mungkin menyimpan atau mencatat data dengan cara yang tidak kamu kendalikan

Rekomendasi:

• Tinjau kebijakan penanganan data MCP server sebelum digunakan
• Hindari menggunakan MCP server eksternal dengan kode sensitif atau proprietary
• Lebih utamakan MCP server lokal untuk proyek rahasia

Risiko keamanan lokal

MCP server lokal:

• Berjalan dengan izin yang sama seperti Bob
• Bisa mengakses file system, environment variable, dan sumber daya sistem
• Mungkin mengeksekusi kode arbitrer di mesinmu
• Berpotensi memodifikasi atau menghapus file

Rekomendasi:

• Instal MCP server hanya dari sumber yang terpercaya
• Tinjau kode sumber MCP server sebelum instalasi jika memungkinkan
• Pahami izin dan kemampuan apa yang diperlukan setiap server
• Berhati-hati dengan server yang meminta akses file system yang luas

Kepatuhan organisasi

Pertimbangan bisnis dan enterprise:

• Pastikan penggunaan MCP server sesuai dengan kebijakan keamanan organisasimu
• Verifikasi bahwa penanganan data mematuhi persyaratan regulasi (GDPR, HIPAA, dll.)
• Periksa apakah MCP server disetujui untuk digunakan dalam jaringan yang dibatasi
• Dokumentasikan MCP server mana yang diotorisasi untuk digunakan di lingkunganmu

Best practice:

• Pertahankan inventaris MCP server yang disetujui
• Buat proses review untuk MCP server baru
• Audit penggunaan dan izin MCP server secara rutin
• Berikan pelatihan keamanan untuk anggota tim yang menggunakan MCP

Memeriksa MCP server

Sebelum menginstal MCP server apapun:

1. Riset sumbernya: Verifikasi reputasi dan rekam jejak publisher
2. Tinjau dokumentasi: Pahami apa yang dilakukan server dan apa yang diaksesnya
3. Periksa izin: Evaluasi sumber daya sistem apa yang diperlukan server
4. Baca kodenya: Jika open source, tinjau implementasinya untuk masalah keamanan
5. Uji dalam isolasi: Coba server di lingkungan non-produksi terlebih dahulu
6. Pantau perilaku: Perhatikan aktivitas jaringan atau akses file yang tidak terduga