MCP serveri

Možete dodati vanjske alate u OpenCode koristeći Model Context Protocol, ili MCP. OpenCode podržava i lokalne i udaljene servere. Jednom dodani, MCP alati su automatski dostupni LLM-u zajedno sa ugrađenim alatima.

Upozorenje

Kada koristite MCP server, on dodaje u kontekst. Ovo se može brzo zbrojiti ako imate puno alata. Stoga preporučujemo da pazite koje MCP servere koristite. :::tip MCP serveri dodaju vaš kontekst, tako da želite da budete pažljivi s tim koje ćete omogućiti. :::

Određeni MCP serveri, poput GitHub MCP servera, mogu dodati mnogo tokena i lako premašiti limit konteksta.

Omogućavanje

Možete definirati MCP servere u vašoj OpenCode Config pod mcp. Dodajte svaki MCP sa jedinstvenim imenom. Možete se pozvati na taj MCP po imenu kada tražite LLM.

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

Također možete onemogućiti server postavljanjem enabled na false. To je korisno kada ga želite privremeno isključiti bez uklanjanja iz konfiguracije.

Poništavanje udaljenih zadanih postavki

Organizacije mogu obezbijediti zadane MCP servere preko svoje krajnje tačke .well-known/opencode. Ovi serveri mogu biti onemogućeni prema zadanim postavkama, omogućavajući korisnicima da se odluče za one koji su im potrebni. Da omogućite određeni server iz udaljene konfiguracije vaše organizacije, dodajte ga u svoju lokalnu konfiguraciju sa enabled: true:

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

Vrijednosti lokalne konfiguracije nadjačavaju udaljene zadane postavke. Pogledajte config precedence za više detalja.

Lokalno

Dodajte lokalne MCP servere koristeći type u "local" unutar MCP objekta.

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

Naredba je način na koji se pokreće lokalni MCP server. Također možete proslijediti listu varijabli okruženja. Na primjer, evo kako možete dodati testni @modelcontextprotocol/server-everything MCP server.

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

I da ga koristim mogu dodati use the mcp_everything tool u svoje upite.

use the mcp_everything tool to add the number 3 and 4

Opcije

Ovdje su sve opcije za konfiguriranje lokalnog MCP servera.

Udaljeno

Dodajte udaljene MCP servere postavljanjem 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 je URL udaljenog MCP servera, a kroz opciju headers možete proslijediti listu zaglavlja.

Opcije

OAuth

OpenCode automatski rukuje OAuth autentifikacijom za udaljene MCP servere. Kada server zahtijeva autentifikaciju, OpenCode će:

1. Otkrijte 401 odgovor i pokrenite OAuth tok
2. Koristite Dynamic Client Registration (RFC 7591) ako podržava server
3. Sigurno čuvajte tokene za buduće zahtjeve

Automatski

Za većinu MCP servera sa omogućenim OAuthom nije potrebna posebna konfiguracija. Samo konfigurirajte udaljeni server:

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

Ako server zahtijeva autentifikaciju, OpenCode će vas tražiti prijavu pri prvom korištenju. Ako se to ne desi, možete ručno pokrenuti tok naredbom opencode mcp auth <server-name>.

Prethodno registrirano

Ako imate klijentske vjerodajnice od dobavljača MCP servera, možete ih konfigurirati:

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

Autentifikacija

Možete ručno pokrenuti autentifikaciju ili upravljati vjerodajnicama. Autentifikacija sa određenim MCP serverom:

opencode mcp auth my-oauth-server

Navedite sve MCP servere i njihov status autentifikacije:

opencode mcp list

Uklonite pohranjene vjerodajnice:

opencode mcp logout my-oauth-server

Komanda mcp auth otvara pretraživač za autorizaciju. Nakon odobrenja, OpenCode sigurno čuva tokene u ~/.local/share/opencode/mcp-auth.json.

Onemogućavanje OAuth-a

Ako želite onemogućiti automatski OAuth za server (npr. za servere koji umjesto toga koriste API ključeve), postavite 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}"
      }
    }
  }
}

OAuth opcije

Otklanjanje grešaka

Ako udaljeni MCP server ne uspije u autentifikaciji, možete dijagnosticirati probleme pomoću:

# 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-server

Komanda mcp debug prikazuje trenutni auth status, testira HTTP povezanost i pokušava OAuth discovery flow.

Upravljanje

Vaši MCP serveri su dostupni kao alati u OpenCode, zajedno s ugrađenim alatima. Možete njima upravljati kroz OpenCode konfiguraciju kao i bilo kojim drugim alatom.

Globalno

To znači da ih možete omogućiti ili onemogućiti globalno.

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

Također možemo koristiti glob obrazac da onemogućimo sve odgovarajuće MCP-ove.

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

Ovdje koristimo glob obrazac my-mcp* da onemogućimo sve MCP servere.

Po agentu

Ako imate veliki broj MCP servera, možda ćete želeti da ih omogućite samo po agentu i da ih onemogućite globalno. Da biste to učinili:

1. Onemogućite ga kao alat globalno.
2. U vašem agent config, omogućite MCP server kao alat.

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

Glob uzorci

Uzorak glob koristi jednostavne šablone globbiranja regularnih izraza:

• * odgovara nuli ili više bilo kojeg znaka (npr. "my-mcp*" odgovara my-mcp_search, my-mcp_list, itd.)
• ? odgovara tačno jednom znaku
• Svi ostali likovi se bukvalno podudaraju :::note MCP serverski alati se registruju sa imenom servera kao prefiksom, tako da onemogućite sve alate za server jednostavno koristite:

"mymcpservername_*": false

:::

Primjeri

Ispod su primjeri uobičajenih MCP servera. Možete poslati PR ako želite dokumentovati druge servere.

Sentry

Dodajte Sentry MCP server za interakciju sa vašim Sentry projektima i problemima.

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

Nakon dodavanja konfiguracije, autentifikujte se sa Sentry:

opencode mcp auth sentry

Ovo će otvoriti prozor pretraživača da završite OAuth tok i povežete OpenCode sa vašim Sentry nalogom. Nakon provjere autentičnosti, možete koristiti Sentry alate u svojim upitima za upite o problemima, projektima i podacima o greškama.

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

Context7

Dodajte Context7 MCP server za pretraživanje dokumenata.

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

Ako ste se prijavili za besplatni račun, možete koristiti svoj API ključ i dobiti viša ograničenja stope.

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

Ovdje pretpostavljamo da imate postavljenu varijablu okruženja CONTEXT7_API_KEY. Dodajte use context7 vašim upitima za korištenje Context7 MCP servera.

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

Alternativno, možete dodati nešto poput ovoga na svoj AGENTS.md.

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

Grep by Vercel

Dodajte Grep by Vercel MCP server za pretraživanje isječaka koda na GitHub.

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

Pošto smo naš MCP server nazvali gh_grep, možete dodati use the gh_grep tool u svoje upite da natjerate agenta da ga koristi.

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

Alternativno, možete dodati nešto poput ovoga na svoj AGENTS.md.

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