Deployment de MCP

Faça o deploy dos 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 que podem ser chamadas de qualquer lugar.

Criando e gerenciando servidores MCP

Servidores MCP agrupam as ferramentas dos seus workflows. Crie e gerencie os servidores nas configurações do workspace:

1. Vá para 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 já em deploy para adicionar como ferramentas de imediato

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

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

Adicionando um workflow como ferramenta

Depois que seu workflow estiver em deploy, você pode expô-lo como uma ferramenta MCP:

1. Abra o workflow em deploy
2. Clique em Deploy e vá para a aba MCP

3. Configure o nome e a descrição da ferramenta (a descrição usa por padrão a descrição do workflow)
4. Revise as descrições dos parâmetros (preenchidas a partir das entradas do seu bloco Start) e sobrescreva o que quiser por ferramenta
5. Selecione a quais servidores MCP ela será adicionada
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 nomes do MCP (por exemplo, search_documents, send_email).

Descrição

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

Parâmetros

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

Conectando clientes MCP

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

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

Cursor

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

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

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

Claude Code

Rode este comando no seu terminal:

claude mcp add "my-studio-workflows" --url "YOUR_SERVER_URL" --header "X-API-Key:$STUDIO_API_KEY"

Claude Desktop

Adicione à configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

VS Code

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

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

Gerenciamento de servidores

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

• Ver ferramentas: veja todos os workflows adicionados a um servidor
• Copiar a URL: obtenha a URL do servidor para os clientes MCP
• Adicionar workflows: adicione mais workflows em deploy como ferramentas
• Remover ferramentas: remova workflows do servidor
• Excluir o servidor: remova o servidor inteiro e todas as suas ferramentas

Como funciona

Quando um cliente MCP chama a sua ferramenta:

1. A requisição é recebida na URL do seu servidor MCP
2. O Seeyu Agent Studio valida a requisição e mapeia os parâmetros para as entradas do workflow
3. O workflow em deploy 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 de API, o que garante um comportamento consistente.

Permissões necessárias