Conectar Claude, Codex, GitHub Copilot o Microsoft 365 Copilot a Skills Workflow
Añade Skills Workflow a la herramienta de IA con la que trabajas. Una vez conectada, la herramienta puede crear páginas de estado, informes y pantallas para tu agencia y publicarlos en tu tenant. La conexión es la misma en todas las herramientas: una dirección y tres cabeceras.
Requisitos previos
Pide al equipo de Skills Workflow los datos de conexión de tu tenant. Recibes cuatro valores:
| Valor | Dónde va |
|---|---|
| La dirección de la API de tu tenant | La dirección del conector |
| App ID | La cabecera x-app-id |
| App key | La cabecera x-app-key |
| Tenant ID | La cabecera x-tenant-id |
La dirección del conector es la dirección de la API de tu tenant seguida de /mcp/client-portal. Para un tenant cuya dirección de la API es https://apiv2-demo-test-we.skillsworkflow.com, es:
https://apiv2-demo-test-we.skillsworkflow.com/mcp/client-portal
Con los datos llegan dos skills, client-portal y app-page. Le dan a la herramienta de IA las reglas de lo que publica: cómo lee una página tus datos, qué puede cargar y cómo se publica. Añádelas a tu herramienta antes de pedir nada; en Claude, en Settings > Capabilities > Skills.
Añadir el conector
Claude
Claude Code
ChatGPT / Codex
GitHub Copilot
Microsoft 365 Copilot
Claude en la web y Claude Desktop comparten los conectores. En los planes Team y Enterprise, un propietario de la organización de Claude añade el conector para todos.
-
Abre Settings > Connectors y selecciona Add custom connector.
-
En el primer campo, escribe un nombre para el conector, por ejemplo
Skills Workflow. Es el nombre que aparece en la lista de conectores. -
En el segundo campo, escribe la dirección del conector y selecciona Continue.
-
Claude comprueba el servidor. Connecting to the server responde
401y las comprobaciones de inicio de sesión responden404: es lo esperado, porque el conector se autentica con cabeceras. Cuando aparezca Server found, selecciona Continue.
Claude encuentra el servidor de Skills Workflow en la dirección del conector. -
En Authentication, selecciona No sign-in.
-
En Request headers, selecciona Add header tres veces y rellena
x-app-key,x-app-idyx-tenant-id, cada una con el valor que envió el equipo de Skills Workflow. Deja Required seleccionado en cada una. -
Selecciona Add.
No sign-in, con las tres cabeceras de petición del conector de Skills Workflow.
Claude guarda los valores de las cabeceras y no vuelve a mostrarlos. Para cambiar uno, quita el conector y vuelve a añadirlo.
Añade el conector desde un terminal:
claude mcp add --transport http skills-workflow https://apiv2-demo-test-we.skillsworkflow.com/mcp/client-portal \
--header "x-app-id: <App ID>" \
--header "x-app-key: <App key>" \
--header "x-tenant-id: <Tenant ID>"
Sustituye la dirección por la de tu tenant y cada <...> por el valor que envió el equipo de Skills Workflow.
En la app de ChatGPT:
-
Abre Plugins y selecciona la pestaña MCPs.
-
Selecciona Add y añade un servidor MCP.
-
En URL, escribe la dirección del conector.
-
Deja Bearer token env var vacío.
-
En Headers, selecciona Add header para cada credencial y rellena
x-app-id,x-tenant-idyx-app-key, cada una con el valor que envió el equipo de Skills Workflow. -
Selecciona Save.
El servidor MCP de Skills Workflow en la app de ChatGPT, con la dirección del conector y sus tres cabeceras.
Codex CLI y la extensión de Codex para IDE leen los mismos servidores de ~/.codex/config.toml. Para añadir el conector ahí:
[mcp_servers.skills-workflow]
url = "https://apiv2-demo-test-we.skillsworkflow.com/mcp/client-portal"
http_headers = { "x-app-id" = "<App ID>", "x-tenant-id" = "<Tenant ID>" }
env_http_headers = { "x-app-key" = "SW_APP_KEY" }
Sustituye la dirección por la de tu tenant y cada <...> por el valor que envió el equipo de Skills Workflow. La app key se lee de la variable de entorno SW_APP_KEY; asígnale la app key antes de iniciar Codex.
En Visual Studio Code, añade el conector a mcp.json, en tu perfil de usuario o en .vscode/mcp.json de un proyecto. Para el archivo de usuario, ejecuta MCP: Open User Configuration desde la Command Palette.
{
"inputs": [
{ "type": "promptString", "id": "sw-app-id", "description": "App ID de Skills Workflow" },
{ "type": "promptString", "id": "sw-app-key", "description": "App key de Skills Workflow", "password": true },
{ "type": "promptString", "id": "sw-tenant-id", "description": "Tenant ID de Skills Workflow" }
],
"servers": {
"skills-workflow": {
"type": "http",
"url": "https://apiv2-demo-test-we.skillsworkflow.com/mcp/client-portal",
"headers": {
"x-app-id": "${input:sw-app-id}",
"x-app-key": "${input:sw-app-key}",
"x-tenant-id": "${input:sw-tenant-id}"
}
}
}
}
Sustituye la dirección por la de tu tenant. La primera vez que se inicia el servidor, Visual Studio Code pide los tres valores y los guarda. No escribas los valores en el archivo de un proyecto que subes con commit.
Cree un agente Skills Workflow en Copilot Studio para los usuarios de Microsoft 365 Copilot o Teams de la agencia. El agente se conecta al tenant mediante el servidor MCP de Skills Workflow.
Requisitos previos
Pida a Skills Workflow la dirección de la API del tenant, App ID, App key, Tenant ID y las skills client-portal y app-page. Necesita acceso a Copilot Studio y permiso para crear conectores personalizados en el mismo entorno Power Platform.
Use un entorno Power Platform con Dataverse. Reserve la App key a los publicadores autorizados: permite publicar y sustituir páginas de todo el tenant como administrador de Skills Workflow.
Crear el conector personalizado
- Abra Power Apps, seleccione el entorno y abra Custom connectors → New custom connector → Create from blank. Asígnele el nombre
Skills Workflow MCP. - Active Swagger editor. Descargue la plantilla OpenAPI, sustituya
YOUR-TENANT-API-HOSTpor el hostname de la API de su tenant (sinhttps://ni ruta) y pegue la definición en el editor. La ruta MCP es/mcp/client-portal. - Desactive Swagger editor y compruebe en Security: autenticación API Key, nombre del parámetro
x-app-key, ubicación Header. Seleccione Create connector.
- Abra Test → New connection, introduzca la App key en el campo protegido
api_keyy seleccione Create. Esto crea la conexión; el estado Connected por sí solo no valida las herramientas MCP.
Crear un agente standard
- En Copilot Studio, seleccione el mismo entorno. Abra Home → Other ways to build → Build with standard orchestration → Agent. Introduzca un nombre y seleccione Create.
- Abra Add tool, busque
Skills Workflowy seleccione Skills Workflow MCP en Model Context Protocol. Seleccione la conexión creada y elija Add. - Abra la herramienta añadida y rellene Inputs:
x-app-idcon App ID yx-tenant-idcon Tenant ID. Seleccione Save. Ambos son headers enviados con la App key de la conexión. Rellénelos en cada agente; no se copian automáticamente desde otro agente.
Probar la conexión MCP
Inicie una nueva sesión de prueba y pregunte qué herramientas Skills Workflow están disponibles. Compare la lista con las ocho herramientas de la sección Comprobar la conexión a continuación.
Después pida al agente que llame a get_portal_url para el cliente hipotético mcp-connection-check y el portal connection-check, sin crear ni modificar nada. Revise el registro de actividad: la herramienta debe terminar con Completed y devolver la URL de su tenant. Esta herramienta devuelve una dirección aunque no exista una página en esa ubicación; no publica ni verifica la página.
Una lista textual de herramientas no basta para validar la conexión. Si el editor muestra Connector request failed, compruebe los tres valores de los headers y los inputs guardados. Confirme el comportamiento en ejecución mediante el resultado real de la herramienta en el registro de prueba.
Preparar el acceso de los key users
Antes de pedir al agente que publique contenido, obtenga y configure con Skills Workflow las reglas oficiales client-portal y app-page. La prueba de conexión anterior no publica el agente ni verifica sus skills.
Para distribuirlo en la organización, siga las instrucciones Microsoft para publicar en Teams y Microsoft Copilot. Pida a IT que revise las licencias, la identidad de la conexión y el grupo de publicadores autorizados antes de poner el agente a disposición de los usuarios. Quienes abren las páginas publicadas se autentican con su propia identidad.
Trial y créditos
Un trial de Copilot Studio puede permitir probar un agente standard. Otros tipos de agente pueden necesitar Copilot Credits para su creación y pruebas. Si aparece EnforcementUsageCredits, pida al administrador que revise Licensing → Copilot Studio → Manage Copilot Credits. Consulte las orientaciones Microsoft sobre capacidad.
Las pantallas dentro de Skills Workflow se construyen como un pequeño proyecto de código. Constrúyelas en una herramienta que trabaje con código: Claude Code, Codex o GitHub Copilot.
Comprobar la conexión
Inicia una conversación nueva y pregunta:
Which Skills Workflow tools do you have?
La respuesta enumera las ocho tools del conector:
| Tool | Qué hace |
|---|---|
get_client_portal | Lee una página de cliente publicada |
create_client_portal | Publica una página de cliente nueva |
update_client_portal | Sustituye una página de cliente publicada |
get_portal_url | Da la dirección de una página de cliente |
get_app_page | Lee una pantalla dentro de Skills Workflow y sus versiones |
publish_app_page_version | Publica una versión nueva de una pantalla |
set_app_page_live_version | Elige la versión de una pantalla que reciben los usuarios |
get_app_page_url | Da la dirección de una pantalla |
Esta pregunta no lee ni escribe nada en tu tenant. Si la herramienta dice que no tiene tools de Skills Workflow, o informa de un error, uno de los valores es incorrecto; compara la dirección y cada cabecera con lo que envió el equipo de Skills Workflow.
Reglas y comportamiento
- Las credenciales solo funcionan en la dirección de la API de tu propio tenant. Cualquier otra dirección las rechaza.
- El conector publica como el administrador de Skills Workflow de tu tenant. Cualquiera que tenga la app key puede crear y sustituir páginas para todos los clientes de tu tenant, así que guárdala entre las pocas personas que publican. Si la key llega a alguien que no debería tenerla, avisa al equipo de Skills Workflow.
- El conector solo llega al sistema de archivos de tu tenant. Publica, vuelve a leer y da la dirección de lo que publica; no cambia jobs, proyectos ni ningún otro registro.
- Quienes abren lo que se ha publicado inician sesión como ellos mismos. La identidad de administrador se usa para publicar, nunca para mostrar datos.