Serwery MCP
Możesz dodać dodatkowe informacje do opencode za pomocą Model Context Protocol, w skrócie MCP. opencode obsługuje zarówno serwery lokalne, jak i zdalne.
Po dodaniu narzędzi MCP są automatycznie dostępne dla LLM wraz z narzędziami narzędziowymi.
Zastrzeżenia
Kiedy używasz serwera MCP, zmieniając kontekst. Może szybko się sumować, jeśli masz dużo narzędzia. Zalecamy ostrożność, z jakich serwerów MCP korzystasz.
Niektóre serwery MCP, takie jak serwer MCP GitHub, mają szerokie możliwości dodawania wielu tokenów i mogą łatwo przekraczać limit kontekstu.
Dostępny serwery MCP w opencode Config w mcp. Dodaj każdy MCP z unikalną nazwą. Możesz zgłosić się do tego MCP po nazwie, pytając LLM.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"name-of-mcp-server": {
// ...
"enabled": true,
},
"name-of-other-mcp-server": {
// ...
},
},
}Możesz także wyłączyć serwer, ustawiając enabled na false. Jest to urządzenie, które jest urządzeniem biologicznym, bez usuwania z urządzenia.
Organizacje mogą udostępniać serwery MCP za pośrednictwem punktu końcowego .well-known/opencode. Serwer może być podłączony, dzięki czemu użytkownicy mogą wybrać te, których.
Aby włączyć serwer ze zdalnej konfiguracji organizacji, dodaj go do wyłączenia za pomocą enabled: true:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"jira": {
"type": "remote",
"url": "https://jira.example.com/mcp",
"enabled": true
}
}
}Lokalne wartości konfiguracyjne za występujące zdalne wartości. Aby uzyskać więcej informacji, zobacz pierwszeństwo konfiguracji.
Dodaj lokalne serwery MCP za pomocą type do "local" w obiekcie MCP.
{
"$schema": "https://opencode.ai/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",
},
},
},
}Polecenie sposobu uruchamiania lokalnego serwera MCP. Można także zainstalować listę konfiguracyjną.
Oto przykładowy sposób dodania testowego serwera MCP @modelcontextprotocol/server-everything.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"mcp_everything": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-everything"],
},
},
}Aby z niego skorzystać, można dodać use the mcp_everything tool do moich podpowiedzi.
use the mcp_everything tool to add the number 3 and 4Opcje
Oto wszystkie opcje lokalnego serwera MCP.
| Opcja | Wpisz | Wymagane | Opis |
|---|---|---|---|
type | String | Y | Typ połączenia z serwerem MCP musi być "local". |
command | Array | Y | Polecenie i argumenty uruchamiające serwer MCP. |
environment | Object | Zmienne ustawienia podczas uruchamiania serwera. | |
enabled | Boolean | Włącz lub wyłącz serwer MCP podczas uruchamiania. | |
timeout | Number | Limit czasu w ms na pobieranie narzędzia z serwera MCP. Wartość domyślna do 5000 (5 sekund). |
Dodaj zdalne serwery MCP, ustawiając type na "remote".
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"my-remote-mcp": {
"type": "remote",
"url": "https://my-mcp-server.com",
"enabled": true,
"headers": {
"Authorization": "Bearer MY_API_KEY"
}
}
}
}url na adres URL zdalnego serwera MCP i za pomocą opcji headers można znaleźć listę nagłówków.
Opcje
| Opcja | Wpisz | Wymagane | Opis |
|---|---|---|---|
type | String | Y | Typ połączenia z serwerem MCP musi być "remote". |
url | String | Y | Adres URL zdalnego serwera MCP. |
enabled | Boolean | Włącz lub wyłącz serwer MCP podczas uruchamiania. | |
headers | Object | Nagłówki do wysłania z wprowadzenia. | |
oauth | Object | Konfiguracja uwierzytelniania OAuth. Zobacz sekcję OAuth poniżej. | |
timeout | Number | Limit czasu w ms na pobieranie narzędzia z serwera MCP. Wartość domyślna do 5000 (5 sekund). |
opencode automatyczne uwierzytelnianie OAuth dla zdalnych serwerów MCP. Gdy serwer wymaga uwierzytelnienia, opencode:
- Wykryj odpowiedź 401 i zainijuj przepływ OAuth
- używa Dynamicznej rejestracji klienta (RFC 7591), jeśli jest obsługiwana przez serwer
- Bezpiecznie przechowuj tokeny na wypadek ewentualnego zastosowania
W innym serwerze MCP z włączoną funkcją OAuth nie jest wymagana specjalna funkcja. Dostępny serwer bezprzewodowy:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"my-oauth-server": {
"type": "remote",
"url": "https://mcp.example.com/mcp"
}
}
}Jeśli serwer wymaga uwierzytelnienia, opencode poprosi Cię o uwierzytelnienie przy próbie jego użycia. Jeśli nie, możesz [ręcznie podłączyć przepływ] (#authenticating) za pomocą opencode mcp auth <server-name>.
Jeśli posiadasz dostęp do klienta od dostawcy serwera MCP, możesz je udostępnić:
{
"$schema": "https://opencode.ai/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"
}
}
}
}Możesz podać potwierdzenie lub potwierdzenie poświadczenia.
Uwierzytelnij się za pomocą standardowego serwera MCP:
opencode mcp auth my-oauth-serverLista wszystkich serwerów MCP i ich status uwierzytelnienia:
opencode mcp listUsuń zapisane dane uwierzytelniające:
opencode mcp logout my-oauth-serverKomenda mcp auth została udostępniona w celu autoryzacji. Po autoryzacji opencode bezpieczne przechowa tokeny w ~/.local/share/opencode/mcp-auth.json.
Wyłączanie OAuth
Jeśli chcesz włączyć automatyczne OAuth dla serwera (np. dla serwerów, które zamiast tego używać kluczy API), ustaw oauth na false:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"my-api-key-server": {
"type": "remote",
"url": "https://mcp.example.com/mcp",
"oauth": false,
"headers": {
"Authorization": "Bearer {env:MY_API_KEY}"
}
}
}
}Opcje OAuth
| Opcja | Wpisz | Opis |
|---|---|---|
oauth | Object | false | Obiekt konfiguracyjny OAuth lub false, aby wyłączyć automatyczne wykrywanie OAuth. |
clientId | String | Identyfikator klienta OAuth. Jeżeli nie zostanie podany, zostanie podjęta próba dynamicznej rejestracji klienta. |
clientSecret | String | Sekret klienta OAuth, plik jest wymagany przez serwer autoryzacji. |
scope | String | Zakresy protokołu OAuth, których należy żądać podczas autoryzacji. |
Debugowanie
Jeśli serwer MCP nie może zostać uwierzytelniony, możesz zdiagnozować problemy z:
# View auth status for all OAuth-capable servers
opencode mcp auth list
# Debug connection and OAuth flow for a specific server
opencode mcp debug my-oauth-serverKomenda mcp debug wyświetlanie stanu uwierzytelniania, testuje sprawdzanie protokołu HTTP i sprawdzenie sprawdzenia procesu OAuth.
Twoje MCP są dostępne jako narzędzie w opencode, obok narzędzi dodatkowych. Można to zrobić poprzez podłączenie opencode, jak również w innym przypadku.
Możesz to włączyć lub wyłączyć globalnie.
{
"$schema": "https://opencode.ai/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
}
}Dostępne są również wzorca globu, aby wyłączyć wszystkie dyski MCP.
{
"$schema": "https://opencode.ai/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
}
}Tutaj znajdziesz wzorca globalnego my-mcp*, aby wyłączyć wszystkie MCP.
Jeśli masz największe serwery MCP, możesz włączyć je tylko dla poszczególnych agentów i być globalnie. Aby to zrobić:
- Wyłącz go jako narzędzie globalnie.
- W konfiguracji agenta włącz serwer MCP jako narzędzie.
{
"$schema": "https://opencode.ai/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
}
}
}
}Wzory globusów
Wzorzec glob wykorzystuje proste wzorce globowania regularnych:
*dopasowuje zero lub więcej dowolnego znaku (np."my-mcp*"dopasowujemy-mcp_search,my-mcp_listitd.)?odpowiada dokładnie jednemu znakowi- Wszystkie pozostałe znaki pasują dosłownie
Poniżej znajdują się przykłady niektórych serwerów MCP. Twój prywatny PR, udostępniany przez inne serwery.
Dodaj serwer Sentry MCP, aby móc wejść w interakcję z projektem i udostępnić Sentry.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"sentry": {
"type": "remote",
"url": "https://mcp.sentry.dev/mcp",
"oauth": {}
}
}
}Po dodaniu konfiguracji uwierzytelnij się za pomocą Sentry:
opencode mcp auth sentrySpowoduje otwarcie okna konfiguracji, w którym można zakończyć proces OAuth i połączyć opencode z kontem Sentry.
Po uwierzytelnieniu oprogramowania Sentry w swoich monitach, aby rozprzestrzeniać zagrożenia, dane i błędy.
Show me the latest unresolved issues in my project. use sentryDodaj serwer Context7 MCP, aby przeszukać dokumenty.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp"
}
}
}Jeśli założyłeś darmowe konto, możesz użyć klucza API i uzyskać wyższy limit stawek.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
}
}
}
}Załóż tutaj, że masz ustawioną zmienną środowiskową CONTEXT7_API_KEY.
Dodaj use context7 do swoich podpowiedzi, aby skorzystać z serwera Context7 MCP.
Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7Alternatywnie możesz zadać coś takiego do pliku AGENTS.md.
When you need to search docs, use `context7` tools.Dodaj serwer MCP Grep by Vercel, aby przeszukać fragmenty kodu w serwisie GitHub.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"gh_grep": {
"type": "remote",
"url": "https://mcp.grep.app"
}
}
}Nazwaliśmy nasz serwer MCP gh_grep, możesz dodać use the gh_grep tool do swoich podpowiedzi, aby agent mógł z niego korzystać.
What's the right way to set a custom domain in an SST Astro component? use the gh_grep toolAlternatywnie możesz zadać coś takiego do pliku AGENTS.md.
If you are unsure how to do something, use `gh_grep` to search code examples from GitHub.