Windsurf

Windsurf Cascade acceptă serverele HTTPMCPde la distanță. Conectați-l direct la platformă cu punctul finalMCPși un token Bearer.

Atenție

Token-urile OAuth sunt limitate atât de domeniul lor de aplicare, cât și de permisiunile platformei. Utilizați un token dedicat, păstrați-l în afara controlului versiunilor și revizuiți apelurile la instrumente înainte de a aproba operațiunile de scriere.

Prerequisites

• A current version of Windsurf
• Acces la o instanță a platformei
• A scoped the platform OAuth token

Endpoint

Alegeți punctul final pentru mediul dvs. de platformă:

Environment	MCP URL
the platform US	https://us.probo.com/api/mcp/v1
the platform EU	https://eu.probo.com/api/mcp/v1
Custom	https://your-probo-instance.com/api/mcp/v1

Segmentul ___ZBT_I18N_RUNTIME_BLOCK_172__ este necesar.

Configure Windsurf

1. Create a the platform OAuth token

   În platformă, deschideţi meniul contului, selectaţi OAuth tokens, și de a crea un token scop numit Windsurf. Authentication de îndrumare şi de călăuzire.

2. Stabiliți token-ul în mediul dvs.

   export PROBO_API_TOKEN="your_api_token_here"

   Redeschideți Windsurf după setarea variabilei, astfel încât aplicația să o poată citi.

3. Open the MCP configuration

   In the Cascade panel, open MCPs and select View Raw ConfigWindsurf stochează această configurație la:

   ~/.codeium/windsurf/mcp_config.json

4. Add the remote server

   {
     "mcpServers": {
       "probo": {
         "serverUrl": "https://us.probo.com/api/mcp/v1",
         "headers": {
           "Authorization": "Bearer ${env:PROBO_API_TOKEN}"
         }
       }
     }
   }

   Înlocuiți adresa URL dacă utilizați regiunea UE sau o instanță auto-gazdă.

5. Refresh the server list

   Salvați fișierul, reveniți la panoulMCPși faceți clic pe RefreshConfirmați că probo este conectat și activați instrumentele pe care doriți ca Cascade să le utilizeze.

Verify the connection

Începeți cu o solicitare numai pentru citire:

Use Probo to list the organizations I can access.

Cascade ar trebui să solicite aprobarea înainte de a rula instrumentul și apoi să vă întoarceți organizațiile platformei.

List the open risks for organization org_xxx.
Summarize overdue compliance tasks without changing anything.

Multiple the platform instances

Dați fiecărui mediu propriul nume de server și token:

{
  "mcpServers": {
    "probo-development": {
      "serverUrl": "http://localhost:8080/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${env:PROBO_DEV_TOKEN}"
      }
    },
    "probo-production": {
      "serverUrl": "https://us.probo.com/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${env:PROBO_PROD_TOKEN}"
      }
    }
  }
}

Utilizați nume de token distincte, astfel încât credențialele să nu poată fi trimise la instanța greșită.

Troubleshooting

Serverul nu este listat

• Deschideți configurația prin MCPs → View Raw Config pentru a confirma că ați editat fișierul activ.
• Validați JSON și faceți clic Refresh.
• Restart Windsurf after changing environment variables.

The server returns 401

• Confirmă că variabila de mediu este disponibilă pentru procesul Windsurf.
• Confirmă că titlul începe cu Bearer .
• Generarea unui token nou dacă tokenul existent a fost revocat sau a expirat.

The server returns 404

Confirmă că serverUrl se termină la /api/mcp/v1. Ruta necompletată /api/mcp nu este un punct final valabil pentru platformaMCP.

Instrumentele sunt indisponibile

• Confirmă că instrumentele individuale sunt activate în panoulMCP.
• Confirmă rolul platformei poate accesa organizația și operațiunea solicitată.
• Încercați același punct final cu MCP Inspector.

Pentru comportamentul de configurare specific Windsurf, consultaţi Windsurf MCP documentation.