MCP-Server

Sie können Dropstone mithilfe des Model Context Protocol (MCP) um externe Tools erweitern. Dropstone unterstützt sowohl lokale als auch entfernte Server.

Nach dem Hinzufügen stehen die MCP-Tools dem LLM automatisch neben den integrierten Tools zur Verfügung.

Einschränkungen

Wenn Sie einen MCP-Server verwenden, wird der Kontext erweitert. Das kann sich schnell summieren, wenn Sie viele Tools haben. Wir empfehlen daher, sorgfältig auszuwählen, welche MCP-Server Sie verwenden.

Bestimmte MCP-Server, wie der GitHub-MCP-Server, erzeugen tendenziell viele Tokens und können das Kontextlimit leicht überschreiten.

Aktivieren

Sie können MCP-Server in Ihrer Dropstone-Konfiguration unter mcp definieren. Fügen Sie jeden MCP-Server mit einem eindeutigen Namen hinzu. Sie können diesen MCP-Server beim Prompting des LLM namentlich referenzieren.

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

Sie können einen Server auch deaktivieren, indem Sie enabled auf false setzen. Das ist nützlich, wenn Sie einen Server vorübergehend deaktivieren möchten, ohne ihn aus Ihrer Konfiguration zu entfernen.

Remote-Standardwerte überschreiben

Organisationen können Standard-MCP-Server über ihren .well-known/dropstone-Endpunkt bereitstellen. Diese Server sind möglicherweise standardmäßig deaktiviert, sodass Benutzer die benötigten Server selbst aktivieren können.

Um einen bestimmten Server aus der Remote-Konfiguration Ihrer Organisation zu aktivieren, fügen Sie ihn mit enabled: true zu Ihrer lokalen Konfiguration hinzu:

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

Ihre lokalen Konfigurationswerte überschreiben die Remote-Standardwerte. Weitere Details finden Sie unter Konfigurationspriorität.

Lokal

Fügen Sie lokale MCP-Server hinzu, indem Sie type auf "local" innerhalb des MCP-Objekts setzen.

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

Der Befehl (command) legt fest, wie der lokale MCP-Server gestartet wird. Sie können auch eine Liste von Umgebungsvariablen übergeben.

Hier ist beispielsweise, wie Sie den Test-MCP-Server @modelcontextprotocol/server-everything hinzufügen können.

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

Um ihn zu verwenden, können Sie use the mcp_everything tool zu Ihren Prompts hinzufügen.

use the mcp_everything tool to add the number 3 and 4

Optionen

Hier sind alle Optionen für die Konfiguration eines lokalen MCP-Servers.

Remote

Fügen Sie Remote-MCP-Server hinzu, indem Sie type auf "remote" setzen.

{
  "$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"
      }
    }
  }
}

Die url ist die URL des Remote-MCP-Servers. Mit der Option headers können Sie eine Liste von Headern übergeben.

Optionen

OAuth

Dropstone übernimmt die OAuth-Authentifizierung für Remote-MCP-Server automatisch. Wenn ein Server eine Authentifizierung erfordert, führt Dropstone Folgendes aus:

1. Erkennt die 401-Antwort und startet den OAuth-Ablauf
2. Verwendet Dynamic Client Registration (RFC 7591), falls vom Server unterstützt
3. Speichert Tokens sicher für zukünftige Anfragen

Automatisch

Für die meisten OAuth-fähigen MCP-Server ist keine spezielle Konfiguration erforderlich. Konfigurieren Sie einfach den Remote-Server:

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

Wenn der Server eine Authentifizierung erfordert, fordert Dropstone Sie bei der ersten Verwendung zur Authentifizierung auf. Falls nicht, können Sie den Ablauf manuell mit dropstone mcp auth <server-name> auslösen.

Vorregistriert

Wenn Sie Client-Anmeldedaten vom MCP-Server-Anbieter haben, können Sie diese konfigurieren:

{
  "$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"
      }
    }
  }
}

Authentifizieren

Sie können die Authentifizierung manuell auslösen oder Anmeldedaten verwalten.

Authentifizieren Sie sich mit einem bestimmten MCP-Server:

dropstone mcp auth my-oauth-server

Listen Sie alle MCP-Server und ihren Authentifizierungsstatus auf:

dropstone mcp list

Entfernen Sie gespeicherte Anmeldedaten:

dropstone mcp logout my-oauth-server

Der Befehl mcp auth öffnet Ihren Browser zur Autorisierung. Nach der Autorisierung speichert Dropstone die Tokens sicher in ~/.local/share/dropstone/mcp-auth.json.

OAuth deaktivieren

Wenn Sie die automatische OAuth-Authentifizierung für einen Server deaktivieren möchten (z. B. für Server, die stattdessen API-Schlüssel verwenden), setzen Sie oauth auf 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}"
      }
    }
  }
}

OAuth-Optionen

Fehlerbehebung

Wenn ein Remote-MCP-Server die Authentifizierung nicht abschließt, können Sie Probleme mit folgenden Befehlen diagnostizieren:

# Authentifizierungsstatus für alle OAuth-fähigen Server anzeigen
dropstone mcp auth list

# Verbindung und OAuth-Ablauf für einen bestimmten Server debuggen
dropstone mcp debug my-oauth-server

Der Befehl mcp debug zeigt den aktuellen Authentifizierungsstatus, testet die HTTP-Konnektivität und versucht den OAuth-Discovery-Ablauf.

Verwalten

Ihre MCPs sind als Tools in Dropstone verfügbar, neben den integrierten Tools. Sie können sie also wie jedes andere Tool über die Dropstone-Konfiguration verwalten.

Global

Das bedeutet, dass Sie sie global aktivieren oder deaktivieren können.

{
  "$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
  }
}

Wir können auch ein Glob-Muster verwenden, um alle passenden MCPs zu deaktivieren.

{
  "$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
  }
}

Hier verwenden wir das Glob-Muster my-mcp*, um alle MCPs zu deaktivieren.

Pro Agent

Wenn Sie eine große Anzahl von MCP-Servern haben, möchten Sie diese möglicherweise nur pro Agent aktivieren und global deaktivieren. Gehen Sie dazu wie folgt vor:

1. Deaktivieren Sie das Tool global.
2. Aktivieren Sie den MCP-Server in Ihrer Agent-Konfiguration als Tool.

{
  "$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
      }
    }
  }
}

Glob-Muster

Das Glob-Muster verwendet einfache Regex-Globbing-Muster:

• * entspricht null oder mehr beliebigen Zeichen (z. B. entspricht "my-mcp*" my-mcp_search, my-mcp_list usw.)
• ? entspricht genau einem Zeichen
• Alle anderen Zeichen werden wörtlich interpretiert

"mymcpservername_*": false

Beispiele

Nachfolgend finden Sie Beispiele für einige gängige MCP-Server. Kontaktieren Sie uns, wenn Sie ein weiteres dokumentiert haben möchten.

Sentry

Fügen Sie den Sentry-MCP-Server hinzu, um mit Ihren Sentry-Projekten und Issues zu interagieren.

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

Nach dem Hinzufügen der Konfiguration authentifizieren Sie sich bei Sentry:

dropstone mcp auth sentry

Dadurch wird ein Browserfenster geöffnet, um den OAuth-Ablauf abzuschließen und Dropstone mit Ihrem Sentry-Konto zu verbinden.

Nach der Authentifizierung können Sie Sentry-Tools in Ihren Prompts verwenden, um Issues, Projekte und Fehlerdaten abzufragen.

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

Context7

Fügen Sie den Context7-MCP-Server hinzu, um in Dokumentationen zu suchen.

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

Wenn Sie sich für ein kostenloses Konto registriert haben, können Sie Ihren API-Schlüssel verwenden und höhere Rate-Limits erhalten.

{
  "$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}"
      }
    }
  }
}

Hier gehen wir davon aus, dass die Umgebungsvariable CONTEXT7_API_KEY gesetzt ist.

Fügen Sie use context7 zu Ihren Prompts hinzu, um den Context7-MCP-Server zu verwenden.

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

Alternativ können Sie etwas wie Folgendes zu Ihrer AGENTS.md hinzufügen.

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

Grep by Vercel

Fügen Sie den Grep by Vercel-MCP-Server hinzu, um in Code-Snippets auf GitHub zu suchen.

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

Da wir unseren MCP-Server gh_grep genannt haben, können Sie use the gh_grep tool zu Ihren Prompts hinzufügen, damit der Agent ihn verwendet.

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

Alternativ können Sie etwas wie Folgendes zu Ihrer AGENTS.md hinzufügen.

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