MCP-Server

Sie können externe Tools zu Dropstone mithilfe des Model Context Protocol oder MCP hinzufügen. Dropstone unterstützt sowohl lokale als auch Remote-Server.

Nach dem Hinzufügen sind MCP-Tools automatisch für das LLM neben integrierten Tools verfügbar.

Einschränkungen

Wenn Sie einen MCP-Server verwenden, trägt dieser zum Kontext bei. Dies kann sich schnell summieren, wenn Sie viele Tools haben. Daher empfehlen wir, vorsichtig zu sein, welche MCP-Server Sie verwenden.

Bestimmte MCP-Server, wie der GitHub MCP-Server, neigen dazu, viele Token hinzuzufügen und können leicht das Kontextlimit überschreiten.

Aktivieren

Sie können MCP-Server in Ihrer Dropstone-Konfiguration unter mcp definieren. Fügen Sie jeden MCP mit einem eindeutigen Namen hinzu. Sie können auf diesen MCP anhand des Namens verweisen, wenn Sie das LLM auffordern.

{
  "$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. Dies 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 können standardmäßig deaktiviert sein, sodass Benutzer sich für die benötigten anmelden können.

Um einen bestimmten Server aus der Remote-Konfiguration Ihrer Organisation zu aktivieren, fügen Sie ihn zu Ihrer lokalen Konfiguration mit enabled: true 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 Informationen finden Sie unter Konfigurationsrangfolge.

Lokal

Fügen Sie lokale MCP-Server hinzu, indem Sie type auf "local" im MCP-Objekt setzen.

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

Der Befehl ist die Art und Weise, 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 es zu verwenden, kann ich use the mcp_everything tool zu meinen Eingabeaufforderungen hinzufügen.

use the mcp_everything tool to add the number 3 and 4

Optionen

Hier sind alle Optionen zum Konfigurieren 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 und mit der Option headers können Sie eine Liste von Headern übergeben.

Optionen

OAuth

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

1. Erkennt die 401-Antwort und initiiert den OAuth-Fluss
2. Verwendet Dynamic Client Registration (RFC 7591), falls vom Server unterstützt
3. Speichert Token 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 auf, sich zu authentifizieren, wenn Sie ihn zum ersten Mal verwenden. Wenn nicht, können Sie den Fluss 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"
      }
    }
  }
}

Authentifizierung

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

Authentifizieren Sie sich bei einem bestimmten MCP-Server:

dropstone mcp auth my-oauth-server

Alle MCP-Server und ihren Authentifizierungsstatus auflisten:

dropstone mcp list

Gespeicherte Anmeldedaten entfernen:

dropstone mcp logout my-oauth-server

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

OAuth deaktivieren

Wenn Sie das automatische OAuth 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

Debugging

Wenn ein Remote-MCP-Server nicht authentifiziert werden kann, können Sie Probleme mit folgenden Mitteln diagnostizieren:

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

# Verbindung und OAuth-Fluss 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-Erkennungsfluss.

Verwalten

Ihre MCPs sind als Tools in Dropstone neben integrierten Tools verfügbar. Sie können sie daher 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 übereinstimmenden 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 es global als Tool.
2. Aktivieren Sie in Ihrer Agent-Konfiguration den MCP-Server 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. "my-mcp*" entspricht my-mcp_search, my-mcp_list usw.)
• ? entspricht genau einem Zeichen
• Alle anderen Zeichen entsprechen wörtlich

"mymcpservername_*": false

Beispiele

Nachfolgend finden Sie Beispiele für einige häufig verwendete MCP-Server. Kontaktieren Sie uns, wenn Sie einen weiteren dokumentiert haben möchten.

Sentry

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

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

Authentifizieren Sie sich nach dem Hinzufügen der Konfiguration bei Sentry:

dropstone mcp auth sentry

Dies öffnet ein Browserfenster, um den OAuth-Fluss abzuschließen und Dropstone mit Ihrem Sentry-Konto zu verbinden.

Nach der Authentifizierung können Sie Sentry-Tools in Ihren Eingabeaufforderungen verwenden, um Probleme, 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 Dokumente zu durchsuchen.

{
  "$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 angemeldet haben, können Sie Ihren API-Schlüssel verwenden und höhere Ratenlimits 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 Sie die Umgebungsvariable CONTEXT7_API_KEY gesetzt haben.

Fügen Sie use context7 zu Ihren Eingabeaufforderungen 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 folgt 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 Code-Snippets auf GitHub zu durchsuchen.

{
  "$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 Eingabeaufforderungen hinzufügen, um den Agent dazu zu bringen, ihn zu verwenden.

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 folgt zu Ihrer AGENTS.md hinzufügen.

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