Publicação via MCP

Publique seus workflows como ferramentas MCP para torná-los acessíveis a assistentes de IA externos como Claude Desktop, Cursor e outros clientes compatíveis com MCP. Isso transforma seus workflows em ferramentas invocáveis de qualquer lugar.

Criando e gerenciando servidores MCP

Servidores MCP agrupam as ferramentas do seu workflow. Crie e gerencie-os nas configurações do workspace:

1. Vá em Settings → MCP Servers

2. Clique em Add
3. Informe um nome e uma descrição opcional
4. Escolha o acesso: API Key (privado, exige o header X-API-Key) ou Public (sem autenticação)
5. Opcionalmente, selecione workflows publicados para adicionar como ferramentas imediatamente

6. Clique em Add Server
7. Clique em Details para ver o servidor MCP

8. Copie a URL do servidor para usar nos clientes MCP
9. Veja e gerencie todas as ferramentas adicionadas ao servidor

Adicionando um workflow como ferramenta

Depois que o workflow estiver publicado, você pode expô-lo como ferramenta MCP:

1. Abra o workflow publicado
2. Clique em Deploy e vá à aba MCP

3. Configure o nome e a descrição da ferramenta (a descrição padrão é a do workflow)
4. Revise as descrições dos parâmetros (pré-preenchidas a partir das entradas do bloco Start) e sobrescreva qualquer uma por ferramenta
5. Selecione a quais servidores MCP adicioná-la
6. Clique em Save Tool

Configuração da ferramenta

Nome da ferramenta

Use letras minúsculas, números e underscores. O nome deve ser descritivo e seguir as convenções de nomenclatura do MCP (por exemplo, search_documents, send_email).

Descrição

Escreva uma descrição clara do que a ferramenta faz. Isso ajuda assistentes de IA a entender quando usá-la. Se deixar em branco, a ferramenta usa a descrição do workflow.

Parâmetros

Os campos de formato de entrada do workflow se tornam parâmetros da ferramenta. A descrição de cada parâmetro usa por padrão a descrição definida nessa entrada no bloco Start; edite aqui para sobrescrever nesta ferramenta (o bloco Start continua sendo a fonte padrão). As descrições ajudam assistentes de IA a fornecer valores corretos.

Conectando clientes MCP

O Zoen gera uma configuração pronta para colar para cada cliente suportado. Para obtê-la:

1. Vá em Settings → MCP Servers
2. Clique em Details no seu servidor
3. Em MCP Client, selecione o cliente — Cursor, Claude Code, Claude Desktop, VS Code ou Zoen
4. Copie a configuração, substituindo $ZOEN_API_KEY pela sua API key do Zoen

Cursor

O Cursor oferece suporte a configuração direta por URL. Adicione às configurações MCP do Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "my-sim-workflows": {
      "url": "YOUR_SERVER_URL",
      "headers": { "X-API-Key": "$ZOEN_API_KEY" }
    }
  }
}

O Cursor também oferece um botão de instalação com um clique na visualização de detalhes do servidor.

Claude Code

Execute este comando no terminal:

claude mcp add "my-sim-workflows" --url "YOUR_SERVER_URL" --header "X-API-Key:$ZOEN_API_KEY"

Claude Desktop

Adicione à config do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "my-sim-workflows": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "YOUR_SERVER_URL", "--header", "X-API-Key:$ZOEN_API_KEY"]
    }
  }
}

VS Code

Adicione às configurações MCP do VS Code (.vscode/mcp.json):

{
  "mcpServers": {
    "my-sim-workflows": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "YOUR_SERVER_URL", "--header", "X-API-Key:$ZOEN_API_KEY"]
    }
  }
}

Gerenciamento do servidor

Na visualização de detalhes do servidor em Settings → MCP Servers, você pode:

• View tools: Ver todos os workflows adicionados a um servidor
• Copy URL: Obter a URL do servidor para clientes MCP
• Add workflows: Adicionar mais workflows publicados como ferramentas
• Remove tools: Remover workflows do servidor
• Delete server: Remover o servidor inteiro e todas as suas ferramentas

Como funciona

Quando um cliente MCP chama a sua ferramenta:

1. A request é recebida na URL do servidor MCP
2. O Zoen valida a request e mapeia os parâmetros para as entradas do workflow
3. O workflow publicado executa com as entradas fornecidas
4. Os resultados são retornados ao cliente MCP

Os workflows executam usando a mesma versão de deployment das chamadas à API, garantindo comportamento consistente.

Permissões necessárias