Créer un MCP

Permet de créer un MCP au sein de l'organisation spécifiée et de récupérer les tools exposés par le MCP Server.

Cette interface permet de créer un MCP au sein de l'organisation spécifiée et de récupérer les tools exposés par le MCP Server.

Méthode de requête

POST

URL de la requête

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

Authentification de la requête

Utilise l'authentification Basic avec la DevKey / le DevSecret de niveau compte et requiert que le compte appelant dispose de l'autorisation de création de MCP de l'organisation.

Requête

Exemple de requête

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"}]
  }'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Basic ${BASIC_TOKEN}	Utilisez le Basic Token obtenu en encodant `DevKey:DevSecret` en Base64.
Content-Type	application/json	Format du corps de la requête.

Paramètres de la requête (Body Parameters)

Champ	Type	Description	required
org_id	String	ID de l'organisation.	true
name	String	Nom du MCP, 20 caractères maximum.	true
display_name	String	Nom d'affichage du MCP, 50 caractères maximum.	false
description	String	Description du MCP, 100 caractères maximum.	true
logo	String	URL de l'icône du MCP.	true
url	String	URL du MCP Server, doit être une adresse publique `http/https`.	true
show_request	Boolean	Indique s'il faut afficher le contenu de la requête pendant l'appel.	true
mcp_transport_type	String	Type de transport MCP, prend en charge `SSE`, `STREAMABLE_HTTP`.	true
headers	Object[]	En-têtes de requête du MCP, 10 éléments maximum ; chaque élément contient `key`, `value`.	false
queries	Object[]	Paramètres de requête du MCP, 30 éléments maximum ; chaque élément contient `key`, `value`.	false

Réponse

Exemple de réponse

{ "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
  }
}

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Champ	Type	Description
mcp_id	String	ID du nouveau MCP.
available	Boolean	Indique si le MCP est disponible.
action_count	Integer	Nombre d'Actions récupérées.

Réponse en cas d'échec

Champ	Type	Description
code	Integer	Code d'erreur.
message	String	Détails de l'erreur.

Codes d'état

Code d'état	Description
200	Succès
400	Erreur de paramètre
401	Non autorisé
403	Autorisation insuffisante
429	Requêtes trop fréquentes
500	Erreur du serveur