Windsurf

Windsurf Cascade acceptă serverele HTTPMCP de la distanță. Conectați-l direct la platformă cu punctul final MCP ș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

The /v1 segment is required.

Configure Windsurf

1. Create a the platform OAuth token

   În platformă, deschideţi meniul contului, selectaţi OAuth tokens, and create a scoped token named Windsurf. See 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 panoul MCP și faceți clic pe Refresh. Confirm that 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ă header-ul începe cu Bearer .
• Generarea unui token nou dacă tokenul existent a fost revocat sau a expirat.

The server returns 404

Confirm that serverUrl ends in /api/mcp/v1. The unversioned /api/mcp Ruta nu este un punct final valabil pentru platforma MCP.

Instrumentele sunt indisponibile

• Confirmă că instrumentele individuale sunt activate în panoul MCP.
• 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.