Server MCP

Anda dapat menambahkan alat eksternal ke Dropstone menggunakan Model Context Protocol, atau MCP. Dropstone mendukung server lokal dan jarak jauh.

Setelah ditambahkan, alat MCP secara otomatis tersedia untuk LLM bersama dengan alat bawaan.

Catatan Penting

Saat Anda menggunakan server MCP, server tersebut menambah konteks. Ini dapat dengan cepat bertambah jika Anda memiliki banyak alat. Jadi kami menyarankan untuk berhati-hati dengan server MCP mana yang Anda gunakan.

Server MCP tertentu, seperti server MCP GitHub, cenderung menambah banyak token dan dapat dengan mudah melebihi batas konteks.

Aktifkan

Anda dapat mendefinisikan server MCP di konfigurasi Dropstone Anda di bawah mcp. Tambahkan setiap MCP dengan nama yang unik. Anda dapat merujuk MCP tersebut dengan nama saat meminta LLM.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "name-of-mcp-server": {
      // ...
      "enabled": true,
    },
    "name-of-other-mcp-server": {
      // ...
    },
  },
}

Anda juga dapat menonaktifkan server dengan mengatur enabled menjadi false. Ini berguna jika Anda ingin menonaktifkan server sementara tanpa menghapusnya dari konfigurasi Anda.

Menimpa default jarak jauh

Organisasi dapat menyediakan server MCP default melalui endpoint .well-known/dropstone mereka. Server ini mungkin dinonaktifkan secara default, memungkinkan pengguna untuk memilih server yang mereka butuhkan.

Untuk mengaktifkan server tertentu dari konfigurasi jarak jauh organisasi Anda, tambahkan ke konfigurasi lokal Anda dengan enabled: true:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "jira": {
      "type": "remote",
      "url": "https://jira.example.com/mcp",
      "enabled": true
    }
  }
}

Nilai konfigurasi lokal Anda menimpa default jarak jauh. Lihat prioritas konfigurasi untuk detail lebih lanjut.

Lokal

Tambahkan server MCP lokal menggunakan type menjadi "local" di dalam objek MCP.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-local-mcp-server": {
      "type": "local",
      // Atau ["bun", "x", "my-mcp-command"]
      "command": ["npx", "-y", "my-mcp-command"],
      "enabled": true,
      "environment": {
        "MY_ENV_VAR": "my_env_var_value",
      },
    },
  },
}

Perintah adalah cara server MCP lokal dimulai. Anda juga dapat memasukkan daftar variabel lingkungan.

Misalnya, berikut cara menambahkan server MCP @modelcontextprotocol/server-everything untuk pengujian.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "mcp_everything": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-everything"],
    },
  },
}

Dan untuk menggunakannya, saya dapat menambahkan use the mcp_everything tool ke prompt saya.

use the mcp_everything tool to add the number 3 and 4

Opsi

Berikut adalah semua opsi untuk mengonfigurasi server MCP lokal.

Jarak Jauh

Tambahkan server MCP jarak jauh dengan mengatur type menjadi "remote".

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-remote-mcp": {
      "type": "remote",
      "url": "https://my-mcp-server.com",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer MY_API_KEY"
      }
    }
  }
}

url adalah URL server MCP jarak jauh dan dengan opsi headers Anda dapat memasukkan daftar header.

Opsi

OAuth

Dropstone secara otomatis menangani autentikasi OAuth untuk server MCP jarak jauh. Saat server memerlukan autentikasi, Dropstone akan:

1. Mendeteksi respons 401 dan memulai alur OAuth
2. Menggunakan Dynamic Client Registration (RFC 7591) jika didukung oleh server
3. Menyimpan token dengan aman untuk permintaan di masa mendatang

Otomatis

Untuk sebagian besar server MCP yang mendukung OAuth, tidak diperlukan konfigurasi khusus. Cukup konfigurasikan server jarak jauh:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-oauth-server": {
      "type": "remote",
      "url": "https://mcp.example.com/mcp"
    }
  }
}

Jika server memerlukan autentikasi, Dropstone akan meminta Anda untuk mengautentikasi saat pertama kali mencoba menggunakannya. Jika tidak, Anda dapat memicu alur secara manual dengan dropstone mcp auth <server-name>.

Terdaftar Sebelumnya

Jika Anda memiliki kredensial klien dari penyedia server MCP, Anda dapat mengonfigurasinya:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-oauth-server": {
      "type": "remote",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "clientId": "{env:MY_MCP_CLIENT_ID}",
        "clientSecret": "{env:MY_MCP_CLIENT_SECRET}",
        "scope": "tools:read tools:execute"
      }
    }
  }
}

Autentikasi

Anda dapat memicu autentikasi secara manual atau mengelola kredensial.

Autentikasi dengan server MCP tertentu:

dropstone mcp auth my-oauth-server

Daftar semua server MCP dan status autentikasinya:

dropstone mcp list

Hapus kredensial yang tersimpan:

dropstone mcp logout my-oauth-server

Perintah mcp auth akan membuka browser Anda untuk otorisasi. Setelah Anda mengotorisasi, Dropstone akan menyimpan token dengan aman di ~/.local/share/dropstone/mcp-auth.json.

Menonaktifkan OAuth

Jika Anda ingin menonaktifkan OAuth otomatis untuk server (misalnya, untuk server yang menggunakan kunci API), atur oauth menjadi false:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-api-key-server": {
      "type": "remote",
      "url": "https://mcp.example.com/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:MY_API_KEY}"
      }
    }
  }
}

Opsi OAuth

Debugging

Jika server MCP jarak jauh gagal mengautentikasi, Anda dapat mendiagnosis masalah dengan:

# Lihat status autentikasi untuk semua server yang mendukung OAuth
dropstone mcp auth list

# Debug koneksi dan alur OAuth untuk server tertentu
dropstone mcp debug my-oauth-server

Perintah mcp debug menampilkan status autentikasi saat ini, menguji konektivitas HTTP, dan mencoba alur penemuan OAuth.

Kelola

MCP Anda tersedia sebagai alat di Dropstone, bersama dengan alat bawaan. Jadi Anda dapat mengelolanya melalui konfigurasi Dropstone seperti alat lainnya.

Global

Ini berarti Anda dapat mengaktifkan atau menonaktifkannya secara global.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-mcp-foo": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-foo"]
    },
    "my-mcp-bar": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-bar"]
    }
  },
  "tools": {
    "my-mcp-foo": false
  }
}

Kita juga dapat menggunakan pola glob untuk menonaktifkan semua MCP yang cocok.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-mcp-foo": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-foo"]
    },
    "my-mcp-bar": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-bar"]
    }
  },
  "tools": {
    "my-mcp*": false
  }
}

Di sini kita menggunakan pola glob my-mcp* untuk menonaktifkan semua MCP.

Per agen

Jika Anda memiliki banyak server MCP, Anda mungkin ingin hanya mengaktifkannya per agen dan menonaktifkannya secara global. Untuk melakukannya:

1. Nonaktifkan sebagai alat secara global.
2. Di konfigurasi agen Anda, aktifkan server MCP sebagai alat.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-mcp": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command"],
      "enabled": true
    }
  },
  "tools": {
    "my-mcp*": false
  },
  "agent": {
    "my-agent": {
      "tools": {
        "my-mcp*": true
      }
    }
  }
}

Pola Glob

Pola glob menggunakan pola regex glob sederhana:

• * cocok dengan nol atau lebih karakter apa pun (misalnya, "my-mcp*" cocok dengan my-mcp_search, my-mcp_list, dll.)
• ? cocok dengan tepat satu karakter
• Semua karakter lain cocok secara literal

"mymcpservername_*": false

Contoh

Di bawah ini adalah contoh beberapa server MCP umum. Hubungi kami jika Anda ingin server lain didokumentasikan.

Sentry

Tambahkan server MCP Sentry untuk berinteraksi dengan proyek dan masalah Sentry Anda.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "sentry": {
      "type": "remote",
      "url": "https://mcp.sentry.dev/mcp",
      "oauth": {}
    }
  }
}

Setelah menambahkan konfigurasi, autentikasi dengan Sentry:

dropstone mcp auth sentry

Ini akan membuka jendela browser untuk menyelesaikan alur OAuth dan menghubungkan Dropstone ke akun Sentry Anda.

Setelah terautentikasi, Anda dapat menggunakan alat Sentry dalam prompt Anda untuk menanyakan masalah, proyek, dan data kesalahan.

Tunjukkan masalah terbaru yang belum terselesaikan di proyek saya. use sentry

Context7

Tambahkan server MCP Context7 untuk mencari melalui dokumentasi.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Jika Anda telah mendaftar untuk akun gratis, Anda dapat menggunakan kunci API Anda dan mendapatkan batas kecepatan yang lebih tinggi.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
      }
    }
  }
}

Di sini kita berasumsi bahwa Anda telah mengatur variabel lingkungan CONTEXT7_API_KEY.

Tambahkan use context7 ke prompt Anda untuk menggunakan server MCP Context7.

Konfigurasikan skrip Cloudflare Worker untuk menyimpan respons API JSON selama lima menit. use context7

Atau, Anda dapat menambahkan sesuatu seperti ini ke AGENTS.md Anda.

Saat Anda perlu mencari dokumentasi, gunakan alat `context7`.

Grep by Vercel

Tambahkan server MCP Grep by Vercel untuk mencari melalui cuplikan kode di GitHub.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "gh_grep": {
      "type": "remote",
      "url": "https://mcp.grep.app"
    }
  }
}

Karena kita menamai server MCP kita gh_grep, Anda dapat menambahkan use the gh_grep tool ke prompt Anda agar agen menggunakannya.

Apa cara yang benar untuk mengatur domain kustom dalam komponen SST Astro? use the gh_grep tool

Atau, Anda dapat menambahkan sesuatu seperti ini ke AGENTS.md Anda.

Jika Anda tidak yakin bagaimana melakukan sesuatu, gunakan `gh_grep` untuk mencari contoh kode dari GitHub.