MCP erstellen

Ermöglicht das Erstellen von MCP innerhalb einer bestimmten Organisation und das Abrufen der vom MCP Server bereitgestellten tools.

Über diese Schnittstelle können Sie MCP innerhalb einer bestimmten Organisation erstellen und die vom MCP Server bereitgestellten tools abrufen.

Anfragemethode

POST

Anfrage-URL

https://api.${endpoint}/v1/org/mcp/create

Authentifizierung der Anfrage

Basic-Authentifizierung mit DevKey / DevSecret auf Kontoebene; das aufrufende Konto muss über die Berechtigung zum Erstellen von MCP der Organisation verfügen.

Anfrage

Beispielanfrage

curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "name": "crm-mcp", "display_name": "CRM MCP", "description": "CRM MCP server", "logo": "https://cdn.example.com/mcp.png", "url": "https://mcp.example.com/sse", "show_request": true, "mcp_transport_type": "SSE", "headers": [{"key": "Authorization", "value": "Bearer token"}], "queries": [{"key": "tenant", "value": "demo"}] }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "name": "crm-mcp",
    "display_name": "CRM MCP",
    "description": "CRM MCP server",
    "logo": "https://cdn.example.com/mcp.png",
    "url": "https://mcp.example.com/sse",
    "show_request": true,
    "mcp_transport_type": "SSE",
    "headers": [{"key": "Authorization", "value": "Bearer token"}],
    "queries": [{"key": "tenant", "value": "demo"}]
  }'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Basic ${BASIC_TOKEN}	Basic Token als Base64-Kodierung von `DevKey:DevSecret`.
Content-Type	application/json	Format des Anfrage-Body.

Anfrageparameter (Body Parameters)

Parameter	Typ	Beschreibung	required
org_id	String	Organisations-ID.	true
name	String	MCP-Name, maximal 20 Zeichen.	true
display_name	String	Anzeigename des MCP, maximal 50 Zeichen.	false
description	String	MCP-Beschreibung, maximal 100 Zeichen.	true
logo	String	URL des MCP-Symbols.	true
url	String	MCP-Server-URL, muss eine öffentliche `http/https`-Adresse sein.	true
show_request	Boolean	Ob der Anfrageinhalt während des Aufrufs angezeigt wird.	true
mcp_transport_type	String	MCP-Übertragungstyp, unterstützt `SSE`, `STREAMABLE_HTTP`.	true
headers	Object[]	MCP-Anfrage-Header, maximal 10 Einträge; jeder Eintrag enthält `key`, `value`.	false
queries	Object[]	MCP-Query-Parameter, maximal 30 Einträge; jeder Eintrag enthält `key`, `value`.	false

Antwort

Beispielantwort

{ "code": 0, "message": "OK", "data": { "mcp_id": "mcp-xxxx", "available": true, "action_count": 3 } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "mcp_id": "mcp-xxxx",
    "available": true,
    "action_count": 3
  }
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
mcp_id	String	ID des neu erstellten MCP.
available	Boolean	Ob das MCP verfügbar ist.
action_count	Integer	Anzahl der abgerufenen Actions.

Fehlerantwort

Feld	Typ	Beschreibung
code	Integer	Fehlercode.
message	String	Fehlerdetails.

Statuscodes

Statuscode	Beschreibung
200	Erfolgreich
400	Ungültige Parameter
401	Nicht autorisiert
403	Unzureichende Berechtigungen
429	Zu viele Anfragen
500	Serverfehler