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.

Peringatan

Ketika Anda menggunakan server MCP, itu menambah konteks. Ini dapat dengan cepat menambah jika Anda memiliki banyak alat. Jadi kami merekomendasikan untuk berhati-hati dengan server MCP mana yang Anda gunakan.

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

Aktifkan

Anda dapat menentukan server MCP dalam konfigurasi Dropstone Anda di bawah mcp. Tambahkan setiap MCP dengan nama unik. Anda dapat merujuk ke MCP tersebut berdasarkan nama saat memberi prompt ke 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 ke false. Ini berguna jika Anda ingin menonaktifkan server sementara tanpa menghapusnya dari konfigurasi Anda.

Mengganti default jarak jauh

Organisasi dapat menyediakan server MCP default melalui titik akhir .well-known/dropstone mereka. Server ini mungkin dinonaktifkan secara default, memungkinkan pengguna untuk memilih 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 mengganti default jarak jauh. Lihat urutan preseden konfigurasi untuk detail selengkapnya.

Lokal

Tambahkan server MCP lokal menggunakan type ke "local" dalam objek MCP.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-local-mcp-server": {
      "type": "local",
      // Or ["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 meneruskan daftar variabel lingkungan.

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

{
  "$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 ke "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 meneruskan daftar header.

Opsi

OAuth

Dropstone secara otomatis menangani autentikasi OAuth untuk server MCP jarak jauh. Ketika 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 depan

Otomatis

Untuk sebagian besar server MCP yang diaktifkan 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 melakukan autentikasi saat pertama kali Anda 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 autentikasi mereka:

dropstone mcp list

Hapus kredensial yang disimpan:

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 ke 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 melakukan autentikasi, Anda dapat mendiagnosis masalah dengan:

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

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

Perintah mcp debug menunjukkan 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
  }
}

Kami 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 kami menggunakan pola glob my-mcp* untuk menonaktifkan semua MCP.

Per agen

Jika Anda memiliki sejumlah besar server MCP, Anda mungkin ingin mengaktifkannya hanya per agen dan menonaktifkannya secara global. Untuk melakukan ini:

1. Nonaktifkan sebagai alat secara global.
2. Dalam 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 globbing regex 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 lainnya cocok secara harfiah

"mymcpservername_*": false

Contoh

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

Sentry

Tambahkan server Sentry MCP 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 diautentikasi, Anda dapat menggunakan alat Sentry dalam prompt Anda untuk menanyakan masalah, proyek, dan data kesalahan.

Show me the latest unresolved issues in my project. use sentry

Context7

Tambahkan server Context7 MCP untuk mencari melalui dokumen.

{
  "$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 laju 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 kami mengasumsikan bahwa Anda telah menetapkan variabel lingkungan CONTEXT7_API_KEY.

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

Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7

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

When you need to search docs, use `context7` tools.

Grep oleh Vercel

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

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

Karena kami menamai server MCP kami gh_grep, Anda dapat menambahkan use the gh_grep tool ke prompt Anda untuk membuat agen menggunakannya.

What's the right way to set a custom domain in an SST Astro component? use the gh_grep tool

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

If you are unsure how to do something, use `gh_grep` to search code examples from GitHub.