the platform MCP server
Introduce serverul platformei MCP, care acoperă modul de autentificare a conexiunilor, cele 293 de instrumente disponibile, testarea numai pentru citire și Inspectorul MCP.
Serverul platformei MCP permite asistenților AI și instrumentelor de dezvoltare să lucreze cu datele platformei dvs. prin intermediul Model Context ProtocolUn client conectat poate descoperi instrumentele platformei, poate inspecta schemele de intrare și, cu permisiunea dvs., poate citi sau modifica înregistrările din cadrul organizației.
Utilizați MCP atunci când doriți:
- Puneți întrebări care necesită context live din platformă.
- Revizuirea riscurilor, a controalelor, a dovezilor, a auditurilor și a altor î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.
How a connection works
Section titled “How a connection works”- Clientul dvs.MCP se conectează la punctul terminal de platformă regional sau auto-gazdă.
- platforma autentifică conexiunea cu OAuth interactiv sau cu un token OAuth scalabil.
- În timpul inițializării, clientul descoperă instrumentele disponibile de pe server și schemele lor JSON.
- Clientul selectează un instrument pe baza solicitării dvs. și solicită aprobarea atunci când politica acestuia o cere.
- platforma verifică atât domeniile de token, cât și permisiunile utilizatorului subiacent înainte de a rula operațiunea.
MCP nu 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ă
Secțiunea intitulată „Conectare 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 platforma servește MCP peste Streamable HTTP; nu expune rutele în stil REST pentru instrumente individuale.
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.
Începeți cu o solicitare doar pentru citire
Secțiunea intitulată „Î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:
Use Probo to list the organizations I can access. Do not change anything.
Apoi includeți o organizație într-o cerere îngustă:
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:
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 clientul MCP.
Instrumente și scheme
Secțiunea intitulată „Instrumente și scheme”the platform currently exposes 293 tools Acestea acoperă organizații, riscuri, controale, cadre, dovezi, documente, audituri, constatări, confidențialitate, terțe părți, recenzii de acces, webhooks, consimțământ pentru cookie-uri și alte fluxuri de lucru de conformitate.
Each tool advertises:
- Un nume și o descriere folosite de client pentru a-l selecta.
- JSON input and output schemas.
- Sfaturi comportamentale, cum ar fi doar de citit, distructive și idempotent.
Sugestiile comportamentale ajută clienții să prezinte aprobări mai sigure, dar nu înlocuiesc revizuirea argumentelor instrumentului.
Explore with MCP Inspector
Section titled “Explore with MCP Inspector”Use the MCP Inspector pentru a explora interactiv platforma MCPServer:
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
Section titled “Operational guidance”- Dați fiecărui client sau mediu propriul token, astfel încât accesul să poată fi revocat independent.
- Acordați numai domeniile cerute de fluxul de lucru.
- Păstrați acreditările în afara controlului sursă, a jurnalelor, a configurației partajate și a prompturilor.
- Necesită aprobarea explicită a instrumentelor de scriere și de distrugere.
- Paginate list operations until
next_cursoreste absent atunci când este necesar un set complet de rezultate. - Revoke exposed or unused credentials promptly.