Salt la conținutul principal
MCP (Model Context Protocol) este un protocol care permite modelelor LLM să acceseze instrumente și servicii personalizate. Un client MCP (Cascade, în acest caz) poate trimite cereri către servere MCP pentru a accesa instrumentele pe care acestea le furnizează. Cascade este acum integrat nativ cu MCP, permițându-ți să îți aduci propria selecție de servere MCP pe care Cascade să le folosească. Consultă documentația oficială MCP pentru mai multe informații.
Utilizatorii Enterprise trebuie să activeze manual această opțiune din setări

​
Adăugarea unui nou plugin MCP

Pluginuri MCP noi pot fi adăugate din Plugin Store, la care poți ajunge făcând clic pe pictograma Plugins din meniul din dreapta sus al panoului Cascade sau din secțiunea Windsurf Settings > Cascade > Plugins. Dacă nu găsești pluginul MCP dorit, îl poți adăuga manual editând fișierul sursă mcp_config.json. Pluginurile MCP oficiale vor apărea cu o bifă albastră, indicând că sunt create de compania serviciului părinte. Când faci clic pe un plugin, apasă Install pentru a pune la dispoziția Cascade serverul și instrumentele acestuia. Windsurf acceptă două tipuri de transport pentru serverele MCP: stdio și http. Pentru serverele http, URL-ul ar trebui să corespundă endpointului și să semene cu https://<your-server-url>/mcp. Suportăm, de asemenea, transport HTTP cu streaming și autentificare MCP.
Asigură-te că apeși butonul de reîmprospătare după ce adaugi un nou plugin MCP.

​
Configurarea instrumentelor MCP

Fiecare plugin are un anumit număr de instrumente la care are acces. Cascade are o limită de 100 de instrumente la care poate avea acces în același timp. La nivel de plugin, poți naviga la fila Tools și poți activa sau dezactiva instrumentele dorite. Sau, din Windsurf Settings, poți face clic pe butonul Manage plugins.

​
mcp_config.json

Fișierul ~/.codeium/windsurf/mcp_config.json este un fișier JSON care conține o listă de servere la care Cascade se poate conecta. JSON-ul ar trebui să urmeze aceeași schemă ca fișierul de configurare pentru Claude Desktop. Iată un exemplu de configurație, care definește un singur server pentru GitHub: 
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<TOKEN_PERSONAL_DE_ACCES>"
      }
    }
  }
}
Este important de menționat că, pentru serverele HTTP, configurația este puțin diferită și necesită câmpul serverUrl. Iată un exemplu de configurație pentru un server HTTP: 
{
  "mcpServers": {
    "figma": {
      "serverUrl": "<url-ul-serverului-tau>/mcp"
    }
  }
}
Pentru serverul MCP Figma Dev Mode, asigurați-vă că ați actualizat aplicația desktop Figma la cea mai recentă versiune pentru a utiliza noul endpoint „/mcp”.
Asigurați-vă că transmiteți argumentele și variabilele de mediu necesare pentru serverele pe care doriți să le folosiți. Consultați repositoryul oficial de referință pentru servere MCP sau OpenTools pentru exemple de servere.

​
Controale de administrare (Teams & Enterprise)

Administratorii de echipă pot activa/dezactiva accesul MCP pentru echipa lor și pot adăuga pe lista albă servere MCP aprobate pe care echipa le poate folosi:

Setări MCP pentru echipă

Setări MCP configurabile pentru echipa ta.
Linkul de mai sus va funcționa doar dacă ai drepturi de administrator pentru echipa ta.
În mod implicit, utilizatorii dintr-o echipă își pot configura propriile servere MCP. Totuși, odată ce adaugi pe lista albă chiar și un singur server MCP, toate serverele care nu sunt pe lista albă vor fi blocate pentru echipa ta.

​
Cum funcționează potrivirea serverului

Când adaugi pe lista de permisiuni un server MCP, sistemul folosește potrivire pe baza tiparelor regex cu următoarele reguli:
  • Potrivire pe întregul șir: Toate tiparele sunt ancorate automat (încadrate cu ^(?:pattern)$) pentru a preveni potrivirile parțiale
  • Câmpul Command: Trebuie să se potrivească exact sau conform tiparului tău regex
  • Tabloul Arguments: Fiecare argument este verificat individual față de tiparul corespunzător
  • Lungimea tabloului: Numărul de argumente trebuie să se potrivească exact între lista de permisiuni și configurația utilizatorului
  • Caractere speciale: Caractere precum $, ., [, ], (, ) au semnificație specială în regex și trebuie escape‑uite cu \ dacă vrei potrivire literală

​
Opțiuni de configurare

Configurație whitelist pentru administratori:
  • Server ID: github-mcp-server
  • Server Config (JSON): (lăsați necompletat)
{}
Config utilizator corespunzătoare (mcp_config.json):
{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}
Acest lucru le permite utilizatorilor să instaleze serverul GitHub MCP cu orice configurație validă, atâta timp cât ID-ul serverului corespunde intrării din Plugin Store.
Configurație whitelist pentru administratori:
  • Server ID: github-mcp-server
  • Server Config (JSON):
{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GITHUB_PERSONAL_ACCESS_TOKEN",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": ""
  }
}
Config utilizator corespunzătoare (mcp_config.json):
{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}
Utilizatorii trebuie să folosească exact această configurație — orice abatere în command sau args va fi blocată. Secțiunea env poate avea valori diferite.
Configurație whitelist pentru administratori:
  • Server ID: python-mcp-server
  • Server Config (JSON):
{
  "command": "python3",
  "args": ["/.*\\.py", "--port", "[0-9]+"]
}
Config utilizator corespunzătoare (mcp_config.json):
{
  "mcpServers": {
    "python-mcp-server": {
      "command": "python3",
      "args": ["/home/user/my_server.py", "--port", "8080"],
      "env": {
        "PYTHONPATH": "/home/user/mcp"
      }
    }
  }
}
Acest exemplu oferă flexibilitate utilizatorilor, menținând securitatea:
  • Regexul /.*\\.py corespunde oricărei căi către un fișier Python, de tipul /home/user/my_server.py
  • Regexul [0-9]+ corespunde oricărui port numeric, precum 8080 sau 3000
  • Utilizatorii pot personaliza căile și porturile, în timp ce administratorii se asigură că sunt executate doar scripturi Python

​
Modele Regex comune

PatternPotriviriExemplu
.*Orice șir/home/user/script.py
[0-9]+Orice număr8080, 3000
[a-zA-Z0-9_]+Alfanumeric + underscoreapi_key_123
\\$HOMELiteral „$HOME”$HOME (fără expandare)
\\.pyLiteral „.py”script.py
\\[cli\\]Literal „[cli]”mcp[cli]

​
Note

​
Ghiduri de configurare pentru administratori

  • Variabile de mediu: Secțiunea env nu este supusă potrivirii cu regex și poate fi configurată liber de utilizatori
  • Instrumente dezactivate: Array-ul disabledTools este gestionat separat și nu intră în potrivirea pe baza listei albe
  • Sensibilitate la majuscule/minuscule: Toate potrivirile sunt sensibile la majuscule/minuscule
  • Gestionarea erorilor: Modelele regex invalide vor fi înregistrate și vor duce la refuzarea accesului
  • Testare: Testează cu atenție modelele regex — modele prea restrictive pot bloca scenarii de utilizare legitime

​
Depanare

Dacă utilizatorii raportează că serverele lor MCP nu funcționează după includerea pe lista de permise:
  1. Verificați potrivirea exactă: Asigurați-vă că tiparul din lista de permise se potrivește exact cu configurația utilizatorului
  2. Verificați escaparea în regex: Caracterele speciale pot necesita escapare (de ex., \. pentru puncte „literal”)
  3. Examinați logurile: Tiparele regex nevalide sunt înregistrate cu avertismente
  4. Testați tiparele: Folosiți un tester regex pentru a verifica dacă tiparele funcționează conform așteptărilor
Rețineți: Odată ce permiteți orice server, toate celelalte servere sunt blocate automat pentru membrii echipei.

​
Informații generale

  • Deoarece apelurile de instrumente MCP pot invoca cod scris de implementatori de server arbitrar, nu ne asumăm răspunderea pentru eșecurile acestor apeluri. În reiterare:
  • În prezent acceptăm tools și resources ale unui server MCP, nu prompts.
⌘I