monadical/opencode
14
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity

chore: generate

Browse Source
This commit is contained in:
opencode-agent[bot]
2026-02-09 17:35:30 +00:00
parent dc53086c1e
commit d578f80f00
222 changed files with 6797 additions and 6590 deletions
Download Patch File Download Diff File Expand all files Collapse all files

119
packages/web/src/content/docs/bs/mcp-servers.mdx
View File

@@ -5,19 +5,22 @@ description: Dodajte lokalne i udaljene MCP alate.
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.
---
#### Upozorenja
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, imaju tendenciju da dodaju mnogo tokena i lako mogu premašiti ograničenje konteksta.
---
## Određeni MCP serveri, poput GitHub MCP servera, imaju tendenciju da dodaju mnogo tokena i lako mogu premašiti ograničenje konteksta.
## Omogući
Možete definirati MCP servere u vašoj [OpenCode Config](https://opencode.ai/docs/config/) pod `mcp`. Dodajte svaki MCP sa jedinstvenim imenom. Možete se pozvati na taj MCP po imenu kada tražite LLM.
```jsonc title="opencode.jsonc" {6}
{
"$schema": "https://opencode.ai/config.json",
@@ -33,12 +36,13 @@ Možete definirati MCP servere u vašoj [OpenCode Config](https://opencode.ai/do
}
```
Također možete onemogućiti server postavljanjem `enabled` na `false`. Ovo je korisno ako želite privremeno onemogućiti server bez uklanjanja iz vaše konfiguracije.
---
## Također možete onemogućiti server postavljanjem `enabled` na `false`. Ovo je korisno ako želite privremeno onemogućiti server bez uklanjanja iz vaše konfiguracije.
### Poništavanje daljinskih 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`:
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
@@ -52,11 +56,12 @@ Da omogućite određeni server iz udaljene konfiguracije vaše organizacije, dod
}
```
Vrijednosti vaše lokalne konfiguracije nadjačavaju udaljene zadane postavke. Pogledajte [config precedence](/docs/config#precedence-order) za više detalja.
---
## Vrijednosti vaše lokalne konfiguracije nadjačavaju udaljene zadane postavke. Pogledajte [config precedence](/docs/config#precedence-order) za više detalja.
## Lokalno
Dodajte lokalne MCP servere koristeći `type` u `"local"` unutar MCP objekta.
```jsonc title="opencode.jsonc" {15}
{
"$schema": "https://opencode.ai/config.json",
@@ -76,6 +81,7 @@ Dodajte lokalne MCP servere koristeći `type` u `"local"` unutar MCP objekta.
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`](https://www.npmjs.com/package/@modelcontextprotocol/server-everything) MCP server.
```jsonc title="opencode.jsonc"
{
"$schema": "https://opencode.ai/config.json",
@@ -89,6 +95,7 @@ Na primjer, evo kako možete dodati testni [`@modelcontextprotocol/server-everyt
```
I da ga koristim mogu dodati `use the mcp_everything tool` u svoje upite.
```txt "mcp_everything"
use the mcp_everything tool to add the number 3 and 4
```
@@ -96,17 +103,21 @@ use the mcp_everything tool to add the number 3 and 4
---
#### Opcije
Ovdje su sve opcije za konfiguriranje lokalnog MCP servera.
| Opcija | Vrsta | Obavezno | Opis || ------------- | ------- | -------- | ----------------------------------------------------------------------------------- |
| `type` | String | Y | Tip veze sa MCP serverom, mora biti `"local"`. |
| `command` | Niz | Y | Naredba i argumenti za pokretanje MCP servera. |
| `environment` | Objekt | | Varijable okruženja koje treba postaviti prilikom pokretanja servera. |
| `enabled` | Boolean | | Omogućite ili onemogućite MCP server pri pokretanju. |
| `timeout` | Broj | | Vremensko ograničenje u ms za dohvaćanje alata sa MCP servera. Podrazumevano je 5000 (5 sekundi). |
| `type` | String | Y | Tip veze sa MCP serverom, mora biti `"local"`. |
| `command` | Niz | Y | Naredba i argumenti za pokretanje MCP servera. |
| `environment` | Objekt | | Varijable okruženja koje treba postaviti prilikom pokretanja servera. |
| `enabled` | Boolean | | Omogućite ili onemogućite MCP server pri pokretanju. |
| `timeout` | Broj | | Vremensko ograničenje u ms za dohvaćanje alata sa MCP servera. Podrazumevano je 5000 (5 sekundi). |
---
## Daljinski
Dodajte udaljene MCP servere postavljanjem `type` na `"remote"`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
@@ -123,28 +134,34 @@ Dodajte udaljene MCP servere postavljanjem `type` na `"remote"`.
}
```
`url` je URL udaljenog MCP servera i sa opcijom `headers` možete proslijediti listu zaglavlja.
---
## `url` je URL udaljenog MCP servera i sa opcijom `headers` možete proslijediti listu zaglavlja.
#### Opcije
| Opcija | Vrsta | Obavezno | Opis || --------- | ------- | -------- | ----------------------------------------------------------------------------------- |
| `type` | String | Y | Tip veze sa MCP serverom, mora biti `"remote"`. |
| `url` | String | Y | URL udaljenog MCP servera. |
| `enabled` | Boolean | | Omogućite ili onemogućite MCP server pri pokretanju. |
| `headers` | Objekt | | Zaglavlja za slanje uz zahtjev. |
| `oauth` | Objekt | | Konfiguracija OAuth provjere autentičnosti. Pogledajte odjeljak [OAuth](#oauth) ispod. |
| `timeout` | Broj | | Vremensko ograničenje u ms za preuzimanje alata sa MCP servera. Podrazumevano je 5000 (5 sekundi). |
| `type` | String | Y | Tip veze sa MCP serverom, mora biti `"remote"`. |
| `url` | String | Y | URL udaljenog MCP servera. |
| `enabled` | Boolean | | Omogućite ili onemogućite MCP server pri pokretanju. |
| `headers` | Objekt | | Zaglavlja za slanje uz zahtjev. |
| `oauth` | Objekt | | Konfiguracija OAuth provjere autentičnosti. Pogledajte odjeljak [OAuth](#oauth) ispod. |
| `timeout` | Broj | | Vremensko ograničenje u ms za preuzimanje alata sa MCP servera. Podrazumevano je 5000 (5 sekundi). |
---
## 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:
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
@@ -157,11 +174,12 @@ Za većinu MCP servera sa omogućenim OAuthom nije potrebna posebna konfiguracij
}
```
Ako server zahtijeva autentifikaciju, OpenCode će od vas zatražiti autentifikaciju kada prvi put pokušate da ga koristite. Ako ne, možete [ručno pokrenuti tok](#authenticating) sa `opencode mcp auth <server-name>`.
---
## Ako server zahtijeva autentifikaciju, OpenCode će od vas zatražiti autentifikaciju kada prvi put pokušate da ga koristite. Ako ne, možete [ručno pokrenuti tok](#authenticating) sa `opencode mcp auth <server-name>`.
### Prethodno registrovano
Ako imate klijentske vjerodajnice od dobavljača MCP servera, možete ih konfigurirati:
```json title="opencode.json" {7-11}
{
"$schema": "https://opencode.ai/config.json",
@@ -182,27 +200,32 @@ Ako imate klijentske vjerodajnice od dobavljača MCP servera, možete ih konfigu
---
### Autentifikacija
Možete ručno pokrenuti autentifikaciju ili upravljati vjerodajnicama.
Autentifikacija sa određenim MCP serverom:
```bash
opencode mcp auth my-oauth-server
```
Navedite sve MCP servere i njihov status autentifikacije:
```bash
opencode mcp list
```
Uklonite pohranjene vjerodajnice:
```bash
opencode mcp logout my-oauth-server
```
Komanda `mcp auth` će otvoriti vaš pretraživač za autorizaciju. Nakon što odobrite, OpenCode će sigurno pohraniti tokene u `~/.local/share/opencode/mcp-auth.json`.
---
## Komanda `mcp auth` će otvoriti vaš pretraživač za autorizaciju. Nakon što odobrite, OpenCode će sigurno pohraniti 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`:
```json title="opencode.json" {7}
{
"$schema": "https://opencode.ai/config.json",
@@ -222,13 +245,17 @@ Ako želite onemogućiti automatski OAuth za server (npr. za servere koji umjest
---
#### OAuth opcije
| Opcija | Vrsta | Opis || -------------- | --------------- | -------------------------------------------------------------------------------- |
| `oauth` | Objekt \| false | OAuth konfiguracijski objekt, ili `false` da onemogućite automatsko otkrivanje OAuth. |
| `oauth` | Objekt \| false | OAuth konfiguracijski objekt, ili `false` da onemogućite automatsko otkrivanje OAuth. |
| `clientId` | String | ID OAuth klijenta. Ako nije navedeno, pokušat će se izvršiti dinamička registracija klijenta. |
| `clientSecret` | String | Tajna OAuth klijenta, ako to zahtijeva autorizacijski server. |
| `scope` | String | OAuth opseg zahtjeva za vrijeme autorizacije. |
| `clientSecret` | String | Tajna OAuth klijenta, ako to zahtijeva autorizacijski server. |
| `scope` | String | OAuth opseg zahtjeva za vrijeme autorizacije. |
#### Otklanjanje grešaka
Ako udaljeni MCP server ne uspije u autentifikaciji, možete dijagnosticirati probleme pomoću:
```bash
# View auth status for all OAuth-capable servers
opencode mcp auth list
@@ -237,15 +264,16 @@ opencode mcp auth list
opencode mcp debug my-oauth-server
```
Komanda `mcp debug` pokazuje trenutni status auth, testira HTTP povezanost i pokušava tok otkrivanja OAuth.
---
## Komanda `mcp debug` pokazuje trenutni status auth, testira HTTP povezanost i pokušava tok otkrivanja OAuth.
## Upravljaj
Vaši MCP-ovi su dostupni kao alati u OpenCode-u, zajedno sa ugrađenim alatima. Tako da možete upravljati njima kroz OpenCode konfiguraciju kao i svaki drugi alat.
---
## Vaši MCP-ovi su dostupni kao alati u OpenCode-u, zajedno sa ugrađenim alatima. Tako da možete upravljati njima kroz OpenCode konfiguraciju kao i svaki drugi alat.
### Global
To znači da ih možete omogućiti ili onemogućiti globalno.
```json title="opencode.json" {14}
{
"$schema": "https://opencode.ai/config.json",
@@ -266,6 +294,7 @@ To znači da ih možete omogućiti ili onemogućiti globalno.
```
Također možemo koristiti glob obrazac da onemogućimo sve odgovarajuće MCP-ove.
```json title="opencode.json" {14}
{
"$schema": "https://opencode.ai/config.json",
@@ -285,13 +314,15 @@ Također možemo koristiti glob obrazac da onemogućimo sve odgovarajuće MCP-ov
}
```
Ovdje koristimo glob obrazac `my-mcp*` da onemogućimo sve MCP-ove.
---
## Ovdje koristimo glob obrazac `my-mcp*` da onemogućimo sve MCP-ove.
### 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](/docs/agents#tools), omogućite MCP server kao alat.
```json title="opencode.json" {11, 14-18}
{
"$schema": "https://opencode.ai/config.json",
@@ -318,12 +349,15 @@ Ako imate veliki broj MCP servera, možda ćete želeti da ih omogućite samo po
---
#### 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
:::napomena
MCP serverski alati se registruju sa imenom servera kao prefiksom, tako da onemogućite sve alate za server jednostavno koristite:
:::napomena
MCP serverski alati se registruju sa imenom servera kao prefiksom, tako da onemogućite sve alate za server jednostavno koristite:
```
"mymcpservername_*": false
```
@@ -333,11 +367,13 @@ MCP serverski alati se registruju sa imenom servera kao prefiksom, tako da onemo
---
## Primjeri
Ispod su primjeri nekih uobičajenih MCP servera. Možete poslati PR ako želite dokumentirati druge servere.
---
## Ispod su primjeri nekih uobičajenih MCP servera. Možete poslati PR ako želite dokumentirati druge servere.
### Stražar
Dodajte [Sentry MCP server](https://mcp.sentry.dev) za interakciju sa vašim Sentry projektima i problemima.
```json title="opencode.json" {4-8}
{
"$schema": "https://opencode.ai/config.json",
@@ -352,12 +388,14 @@ Dodajte [Sentry MCP server](https://mcp.sentry.dev) za interakciju sa vašim Sen
```
Nakon dodavanja konfiguracije, autentifikujte se sa Sentry:
```bash
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.
```txt "use sentry"
Show me the latest unresolved issues in my project. use sentry
```
@@ -365,7 +403,9 @@ Show me the latest unresolved issues in my project. use sentry
---
### Kontekst7
Dodajte [Context7 MCP server](https://github.com/upstash/context7) za pretraživanje dokumenata.
```json title="opencode.json" {4-7}
{
"$schema": "https://opencode.ai/config.json",
@@ -379,6 +419,7 @@ Dodajte [Context7 MCP server](https://github.com/upstash/context7) za pretraživ
```
Ako ste se prijavili za besplatni račun, možete koristiti svoj API ključ i dobiti viša ograničenja stope.
```json title="opencode.json" {7-9}
{
"$schema": "https://opencode.ai/config.json",
@@ -396,11 +437,13 @@ Ako ste se prijavili za besplatni račun, možete koristiti svoj API ključ i do
Ovdje pretpostavljamo da imate postavljenu varijablu okruženja `CONTEXT7_API_KEY`.
Dodajte `use context7` vašim upitima za korištenje Context7 MCP servera.
```txt "use context7"
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](/docs/rules/).
```md title="AGENTS.md"
When you need to search docs, use `context7` tools.
```
@@ -408,7 +451,9 @@ When you need to search docs, use `context7` tools.
---
### Grep od Vercela
Dodajte [Grep by Vercel](https://grep.app) MCP server za pretraživanje isječaka koda na GitHubu.
```json title="opencode.json" {4-7}
{
"$schema": "https://opencode.ai/config.json",
@@ -422,11 +467,13 @@ Dodajte [Grep by Vercel](https://grep.app) MCP server za pretraživanje isječak
```
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.
```txt "use the gh_grep tool"
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](/docs/rules/).
```md title="AGENTS.md"
If you are unsure how to do something, use `gh_grep` to search code examples from GitHub.
```