Ligar o Claude, o Codex, o GitHub Copilot ou o Microsoft 365 Copilot à Skills Workflow
Adicione o Skills Workflow à ferramenta de IA com que trabalha. Depois de ligada, a ferramenta pode criar páginas de estado, relatórios e ecrãs para a sua agência e publicá-los no seu tenant. A ligação é igual em todas as ferramentas: um endereço e três headers.
Pré-requisitos
Peça à equipa do Skills Workflow os dados de ligação do seu tenant. Recebe quatro valores:
| Valor | Onde é usado |
|---|---|
| O endereço da API do seu tenant | O endereço do conector |
| App ID | O header x-app-id |
| App key | O header x-app-key |
| Tenant ID | O header x-tenant-id |
O endereço do conector é o endereço da API do seu tenant seguido de /mcp/client-portal. Para um tenant cujo endereço da API é https://apiv2-demo-test-we.skillsworkflow.com, é:
https://apiv2-demo-test-we.skillsworkflow.com/mcp/client-portal
Com os dados vêm duas skills, client-portal e app-page. Dão à ferramenta de IA as regras do que publica: como uma página lê os seus dados, o que pode carregar e como é publicada. Adicione-as à sua ferramenta antes de pedir o que quer que seja; no Claude, em Settings > Capabilities > Skills.
Adicionar o conector
Claude
Claude Code
ChatGPT / Codex
GitHub Copilot
Microsoft 365 Copilot
O Claude na web e o Claude Desktop partilham os conectores. Nos planos Team e Enterprise, é um owner da organização no Claude que adiciona o conector para todos.
-
Abra Settings > Connectors e selecione Add custom connector.
-
No primeiro campo, escreva um nome para o conector, por exemplo
Skills Workflow. É o nome que aparece na lista de conectores. -
No segundo campo, escreva o endereço do conector e selecione Continue.
-
O Claude verifica o servidor. Connecting to the server responde
401e as verificações de início de sessão respondem404: é o esperado, porque o conector se autentica com headers. Quando aparecer Server found, selecione Continue.
O Claude encontra o servidor do Skills Workflow no endereço do conector. -
Em Authentication, selecione No sign-in.
-
Em Request headers, selecione Add header três vezes e preencha
x-app-key,x-app-idex-tenant-id, cada um com o valor que a equipa do Skills Workflow enviou. Deixe Required selecionado em cada um. -
Selecione Add.
No sign-in, com os três request headers do conector do Skills Workflow.
O Claude guarda os valores dos headers e não volta a mostrá-los. Para alterar um, remova o conector e adicione-o de novo.
Adicione o conector a partir de um 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>"
Substitua o endereço pelo do seu tenant e cada <...> pelo valor que a equipa do Skills Workflow enviou.
Na app do ChatGPT:
-
Abra Plugins e selecione o separador MCPs.
-
Selecione Add e adicione um servidor MCP.
-
Em URL, escreva o endereço do conector.
-
Deixe Bearer token env var vazio.
-
Em Headers, selecione Add header para cada credencial e preencha
x-app-id,x-tenant-idex-app-key, cada um com o valor que a equipa do Skills Workflow enviou. -
Selecione Save.
O servidor MCP do Skills Workflow na app do ChatGPT, com o endereço do conector e os seus três headers.
O Codex CLI e a extensão do Codex para IDE leem os mesmos servidores de ~/.codex/config.toml. Para adicionar o conector aí:
[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" }
Substitua o endereço pelo do seu tenant e cada <...> pelo valor que a equipa do Skills Workflow enviou. A app key é lida da variável de ambiente SW_APP_KEY; defina-a com a app key antes de iniciar o Codex.
No Visual Studio Code, adicione o conector ao mcp.json, no seu perfil de utilizador ou em .vscode/mcp.json de um projeto. Para o ficheiro do utilizador, execute MCP: Open User Configuration a partir da Command Palette.
{
"inputs": [
{ "type": "promptString", "id": "sw-app-id", "description": "App ID do Skills Workflow" },
{ "type": "promptString", "id": "sw-app-key", "description": "App key do Skills Workflow", "password": true },
{ "type": "promptString", "id": "sw-tenant-id", "description": "Tenant ID do 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}"
}
}
}
}
Substitua o endereço pelo do seu tenant. Na primeira vez que o servidor arranca, o Visual Studio Code pede os três valores e guarda-os. Não escreva os valores no ficheiro de um projeto que faz commit.
Crie um agente Skills Workflow no Copilot Studio para os utilizadores de Microsoft 365 Copilot ou Teams da agência. O agente liga-se ao tenant através do servidor MCP da Skills Workflow.
Pré-requisitos
Peça à Skills Workflow o endereço da API do tenant, App ID, App key, Tenant ID e as skills client-portal e app-page. Precisa de acesso ao Copilot Studio e de permissão para criar conectores personalizados no mesmo ambiente Power Platform.
Use um ambiente Power Platform com Dataverse. Reserve a App key aos publicadores autorizados: permite publicar e substituir páginas de todo o tenant como administrador da Skills Workflow.
Criar o conector personalizado
- Abra o Power Apps, selecione o ambiente e abra Custom connectors → New custom connector → Create from blank. Dê-lhe o nome
Skills Workflow MCP. - Ative Swagger editor. Descarregue o modelo OpenAPI, substitua
YOUR-TENANT-API-HOSTpelo hostname da API do tenant (semhttps://nem caminho) e cole a definição no editor. O caminho MCP é/mcp/client-portal. - Desative Swagger editor e confirme em Security: autenticação API Key, nome do parâmetro
x-app-key, localização Header. Selecione Create connector.
- Abra Test → New connection, introduza a App key no campo protegido
api_keye selecione Create. Isto cria a ligação; o estado Connected, por si só, não valida as ferramentas MCP.
Criar um agente standard
- No Copilot Studio, selecione o mesmo ambiente. Abra Home → Other ways to build → Build with standard orchestration → Agent. Introduza um nome e selecione Create.
- Abra Add tool, pesquise
Skills Workflowe selecione Skills Workflow MCP em Model Context Protocol. Selecione a ligação criada e escolha Add. - Abra a ferramenta adicionada e preencha Inputs:
x-app-idcom App ID ex-tenant-idcom Tenant ID. Selecione Save. Ambos são headers enviados com a App key da ligação. Preencha-os em cada agente; não são copiados automaticamente de outro agente.
Testar a ligação MCP
Inicie uma nova sessão de teste e pergunte quais as ferramentas Skills Workflow disponíveis. Compare a lista com as oito ferramentas na secção Confirmar a ligação abaixo.
Depois peça ao agente para chamar get_portal_url para o cliente hipotético mcp-connection-check e o portal connection-check, sem criar nem alterar nada. Verifique o registo de atividade: a ferramenta deve terminar com Completed e devolver o URL do seu tenant. Esta ferramenta devolve um endereço mesmo que não exista uma página nesse local; não publica nem verifica a página.
Uma lista textual de ferramentas não basta para validar a ligação. Se o editor mostrar Connector request failed, confirme os três valores dos headers e os inputs guardados. Confirme o comportamento em execução pelo resultado real da ferramenta no registo do teste.
Preparar o acesso dos key users
Antes de pedir ao agente para publicar conteúdo, obtenha e configure com a Skills Workflow as regras oficiais client-portal e app-page. O teste de ligação acima não publica o agente nem verifica as suas skills.
Para disponibilizar na organização, siga as instruções Microsoft de publicação no Teams e Microsoft Copilot. Peça ao IT para rever o licenciamento, a identidade da ligação e o grupo de publicadores autorizados antes de disponibilizar o agente. Quem abre as páginas publicadas autentica-se com a sua própria identidade.
Trial e créditos
Um trial do Copilot Studio pode permitir testar um agente standard. Outros tipos de agente podem precisar de Copilot Credits para criação e testes. Se aparecer EnforcementUsageCredits, peça ao administrador para verificar Licensing → Copilot Studio → Manage Copilot Credits. Consulte as orientações Microsoft sobre capacidade.
Os ecrãs dentro do Skills Workflow são construídos como um pequeno projeto de código. Construa-os numa ferramenta que trabalhe sobre código: Claude Code, Codex ou GitHub Copilot.
Confirmar a ligação
Comece uma nova conversa e pergunte:
Which Skills Workflow tools do you have?
A resposta lista as oito tools do conector:
| Tool | O que faz |
|---|---|
get_client_portal | Lê uma página de cliente publicada |
create_client_portal | Publica uma nova página de cliente |
update_client_portal | Substitui uma página de cliente publicada |
get_portal_url | Dá o endereço de uma página de cliente |
get_app_page | Lê um ecrã dentro do Skills Workflow e as suas versões |
publish_app_page_version | Publica uma nova versão de um ecrã |
set_app_page_live_version | Escolhe a versão de um ecrã que os utilizadores recebem |
get_app_page_url | Dá o endereço de um ecrã |
Esta pergunta não lê nem escreve nada no seu tenant. Se a ferramenta disser que não tem tools do Skills Workflow, ou mostrar um erro, um dos valores está errado; compare o endereço e cada header com o que a equipa do Skills Workflow enviou.
Regras e comportamento
- As credenciais só funcionam no endereço da API do seu próprio tenant. Qualquer outro endereço recusa-as.
- O conector publica como o administrador do Skills Workflow do seu tenant. Quem tiver a app key pode criar e substituir páginas para todos os clientes do seu tenant, por isso mantenha-a com as poucas pessoas que publicam. Se a key chegar a alguém que não a deveria ter, avise a equipa do Skills Workflow.
- O conector só acede ao sistema de ficheiros do seu tenant. Publica, lê de volta e dá o endereço do que publica; não altera jobs, projetos nem nenhum outro registo.
- Quem abre o que foi publicado inicia sessão como si próprio. A identidade de administrador é usada para publicar, nunca para mostrar dados.