# the platform MCP server

Serverul platformeiMCPpermite asistenților de inteligență artificială și instrumentelor de dezvoltare să lucreze cu datele platformei dvs. prin intermediul Open [Model Context Protocol] (https://modelcontextprotocol.io/). Un client conectat poate descoperi instrumentele platformei, poate inspecta schemele de intrare și - cu autorizația dvs. - poate citi sau schimba înregistrările cuprinse în organizație.

UtilizațiMCPatunci când doriți:

- Puneți întrebări care necesită un context live de la platformă. - Revizuiți riscurile, controalele, dovezile, auditurile și alte înregistrări de conformitate. - Creați sau actualizați înregistrări de la un asistent AI. - Construiți un flux de lucru agentic fără a implementa fiecare operațiune platformăAPI.

:::cauză CliențiiMCPpot invoca instrumente de scriere și de distrugere.Revizuiți instrumentul solicitat și argumentele acestuia înainte de a aproba un apel, mai ales atunci când solicitarea actualizează sau șterge datele. :::

## How a connection works

1. Clientul dvs.MCPse conectează la punctul terminal regional sau auto-hostat al platformei.2. platforma autentifică conexiunea cu OAuth interactiv sau cu un token OAuth cuprinzător.3.În timpul inițializării, clientul descoperă instrumentele disponibile de pe server și schemele lor JSON.4.Clientul selectează un instrument pe baza solicitării dvs. și solicită aprobarea atunci când politica sa o cere.5.platforma verifică atât domeniile tokenului, cât și permisiunile utilizatorului subiacent înainte de a rula operațiunea.

MCPnu ocolește controalele de acces ale platformei. un token poate accesa o organizație și poate efectua o operațiune numai atunci când atât domeniul său de aplicare, cât și permisiunile utilizatorului permit acest lucru.

## Conectează-te la platformă

Selectați punctul final al implementării care conține datele dvs.:

| Deployment  | MCP endpoint                      |
| ----------- | --------------------------------- |
| the platform US    | `https://us.probo.com/api/mcp/v1` |
| the platform EU    | `https://eu.probo.com/api/mcp/v1` |
| Self-hosted | `https://<your-host>/api/mcp/v1`  |

The `/api/mcp/v1` path is required. the platform serves MCP over Streamable HTTP; it
does not expose REST-style routes for individual tools.

Cei mai mulți clienți interactivi descoperă configurația OAuth a platformei și deschid un flux de autorizare a browserului.Pentru un client care necesită o configurație statică, creați un token OAuth cuprinzător în platformă și trimiteți-l ca acreditare purtător.

- [Alege o integrare](/docs/developers/api/mcp/integrations) - Conectați Claude, Cursor, VS Code, OpenAI sau alt client acceptat - [Autentificare](/docs/developers/api/mcp/autentificare) - Configurează OAuth, domenii, reîmprospătarea tokenurilor și credențiale statice

## Începeți cu o solicitare doar pentru citire

După conectarea unui client, confirmați limita identității și a organizației înainte de a-i cere să schimbe datele:

```text
Use Probo to list the organizations I can access. Do not change anything.
```

Apoi includeți o organizație într-o cerere îngustă:

```text
For organization org_xxx, summarize open high-priority risks and cite the
record names and IDs. Do not change anything.
```

ID-urile explicite ale organizației elimină ambiguitatea atunci când un cont poate accesa mai mult de o organizație.

Când sunteți gata să testați o scriere, specificați rezultatul dorit și cereți clientului să prezinte argumentele propuse înainte de a invoca instrumentul:

```text
Prepare a new third party named Acme Corp for cloud hosting in organization
org_xxx. Show me the tool and arguments first; do not create it until I approve.
```

Experiența exactă de aprobare depinde de clientulMCP.

## Instrumente și scheme

platforma expune în prezent **293 de instrumente** generate din specificațiile serverului său. Acestea acoperă organizații, riscuri, controale, cadre, dovezi, documente, audituri, constatări, confidențialitate, părți terțe, recenzii de acces, webhooks, consimțământul pentru cookie-uri și alte fluxuri de lucru de conformitate.

Each tool advertises:

- Un nume și o descriere utilizate de client pentru a-l selecta. - Scheme de intrare și ieșire JSON. - Sfaturi comportamentale, cum ar fi doar citire, distructive și idempotent.

Sugestiile comportamentale ajută clienții să prezinte aprobări mai sigure, dar nu înlocuiesc revizuirea argumentelor instrumentului.

- [Căutați referința instrumentuluiMCP](/docs/developers/api/mcp/tools) — Găsiți nume de instrumente, scheme, categorii și indicii de comportament

## Explore with MCP Inspector

Utilizați [MCPInspector] (https://github.com/modelcontextprotocol/inspector) pentru a explora interactiv platformaMCPServer:

```bash
export PROBO_OAUTH_TOKEN="your_oauth_token"
npx @modelcontextprotocol/inspector --cli \
  https://us.probo.com/api/mcp/v1 \
  --transport http \
  --header "Authorization: Bearer $PROBO_OAUTH_TOKEN" \
  --method tools/list
```

Comanda enumeră instrumentele disponibile prin intermediul serverului. Înlocuiește punctul final pentru regiunea UE sau o implementare auto-gazdă. Inspectorul poate, de asemenea, să navigheze prin scheme, să apeleze instrumente și să expună erorile de protocol în timpul rezolvării problemelor.

## Operational guidance

- Give each client or environment its own token so access can be revoked
  independently.
- Grant only the scopes required by the workflow.
- Keep credentials out of source control, logs, shared configuration, and
  prompts.
- Require explicit approval for write and destructive tools.
- Paginate list operations until `next_cursor` is absent when a complete result
  set is required.
- Revoke exposed or unused credentials promptly.

## Next steps

- [Rezultatele paginate](/docs/developers/api/mcp/pagination) — Seturi de rezultate complete de proces din instrumentele de listă a platformelor - [Browse integrations](/docs/developers/api/mcp/integrations) — Urmați instrucțiunile de setare pentru clientul dvs.MCP