Web Data Forms

Dê a assistentes de IA acesso seguro aos dados de negócios estruturados da sua organização. Pesquise registros, crie e atualize registros, recupere informações de esquema e gerencie estados de fluxo de trabalho usando linguagem natural.

GitHubExperimente este MCPPatrocinado

Documentação

Instruções do Servidor MCP Web Data Forms

Conecte assistentes de IA como Claude e ChatGPT à sua conta Web Data Forms para que eles possam pesquisar envios, criar novos envios, atualizar dados existentes e gerenciar fluxos de trabalho usando linguagem natural.

Por exemplo, use comandos como:

  • "Encontre os dados de contato de João Silva."
  • "Crie uma nova solicitação de suporte."
  • "Mostre os relatórios de inspeção desta semana."
  • "Atualize o status do fluxo de trabalho para Concluído."
  • "Crie uma nova solicitação de licença de funcionário."

O servidor foi projetado para ser stateless. Ele não armazena suas credenciais. Em vez disso, as credenciais são passadas em tempo de execução para cada solicitação.

Para mais informações sobre Web Data Forms, visite https://www.webdataforms.com.

Sumário

O que este servidor pode fazer

Este servidor expõe as seguintes ferramentas:

  • wdf_data_templates_list — lista os Data Templates (Formulários) habilitados para automação disponíveis para o grupo atual, para que você possa identificar o Data Template (Formulário) correto antes de trabalhar com envios.
  • wdf_data_templates_get_schema_and_sample_submissions — recupera as definições de campos de um formulário, as definições de campos pesquisáveis e exemplos representativos de envios.
  • wdf_data_templates_submissions_list_recent — lista envios recentes para um Data Template (Formulário) específico quando você deseja uma visão geral em vez de uma pesquisa direcionada.
  • wdf_data_templates_submissions_get — recupera o conteúdo completo e os metadados de um envio específico pelo Número do Envio.
  • wdf_data_templates_submissions_search — pesquisa envios por um valor de campo pesquisável, usando valores que estão explicitamente marcados como pesquisáveis no Data Template (Formulário).
  • wdf_data_templates_submissions_create — cria um novo envio para um Data Template (Formulário) usando os IDs de campo do esquema.
  • wdf_data_templates_submissions_update — atualiza um envio existente, com a ressalva de que substitui todo o objeto de dados do envio em vez de mesclar alterações.
  • wdf_data_templates_submissions_get_workflow_meta — recupera os status de fluxo de trabalho válidos, prioridades, tipos e usuários atribuíveis para o grupo atual.
  • wdf_data_templates_submissions_update_workflow — substitui o estado do fluxo de trabalho de um envio pelos valores exatos de status, prioridade, tipo, responsável e comentário que você fornecer.

Configuração

Credenciais necessárias

Você precisa de dois valores para cada solicitação:

  • x-api-key — sua Chave de API do Web Data Forms
  • x-group-id — seu ID de Grupo do Web Data Forms

Você pode encontrá-los na página grupo->informações da sua conta Web Data Forms.

Método preferido: cabeçalhos de solicitação

Quando possível, passe as credenciais como cabeçalhos HTTP:

  • x-api-key: <your-api-key>
  • x-group-id: <your-group-id>

Esta é a opção preferida porque mantém as credenciais fora da URL e é mais segura.

Método alternativo: parâmetros de consulta

Se o seu cliente MCP não suportar cabeçalhos personalizados, o servidor também aceita as credenciais como parâmetros de consulta na URL:

  • ?x-api-key=<your-api-key>&x-group-id=<your-group-id>

Exemplo:

https://mcp.webdataforms.com?x-api-key=abc123&x-group-id=xyz456

Modelo de implantação atual

Neste momento, o servidor deve ser usado apenas por meio do endpoint remoto hospedado. O uso local via stdio não é o caminho suportado para usuários finais.

Se o seu cliente não puder enviar cabeçalhos personalizados, use o método alternativo de parâmetros de consulta descrito acima.

Opções de transporte

Este servidor atualmente é destinado ao uso remoto via HTTP Streamable.

Transporte remoto HTTP Streamable

Use esta opção para todas as implantações suportadas.

O endpoint HTTP é:

https://mcp.webdataforms.com

Como conectar ao servidor

Conexão somente remota

Conecte seu cliente MCP à URL remota hospedada e envie as credenciais como cabeçalhos quando suportado.

Exemplo com cabeçalhos:

curl -X POST "https://mcp.webdataforms.com" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -H "x-group-id: your-group-id" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Exemplo usando parâmetros de consulta como alternativa:

curl -X POST "https://mcp.webdataforms.com?x-api-key=your-api-key&x-group-id=your-group-id" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Ferramentas

1) wdf_data_templates_list

Use esta ferramenta primeiro quando precisar descobrir quais Data Templates (Formulários) habilitados para automação estão disponíveis no grupo atual.

Caso de uso típico:

  • "Liste os Data Templates (Formulários) disponíveis no meu grupo."
  • "Mostre os Data Templates (Formulários) com os quais posso trabalhar."

O que ela retorna:

  • Uma lista de Data Templates (Formulários) disponíveis para o grupo ativo.

Melhor prática:

  • Chame esta ferramenta antes de tentar criar, pesquisar ou atualizar envios para identificar um ID de Data Template válido.

2) wdf_data_templates_get_schema_and_sample_submissions

Use esta ferramenta sempre que precisar entender a estrutura de um Data Template (Formulário) antes de criar, atualizar ou pesquisar envios.

Entrada necessária:

  • dataTemplateId

O que ela retorna:

  • Os campos do formulário, incluindo seus IDs de campo
  • Os campos pesquisáveis que podem ser usados com wdf_data_templates_submissions_search
  • Exemplos representativos de envios que mostram a estrutura e os valores esperados

Melhor prática:

  • Sempre use esta ferramenta antes de criar um novo envio se precisar saber quais campos são obrigatórios ou suportados.
  • Os IDs de campo retornados aqui são exatamente as chaves esperadas por wdf_data_templates_submissions_create e wdf_data_templates_submissions_update; use-os em vez dos rótulos de exibição.

3) wdf_data_templates_submissions_list_recent

Use esta ferramenta para navegar ou revisar envios recentes de um Data Template (Formulário) quando não precisar de uma pesquisa direcionada.

Entrada necessária:

  • dataTemplateId
  • opcional limit

Caso de uso típico:

  • "Mostre os últimos 10 envios para este Data Template (Formulário)."

Melhor prática:

  • Use esta ferramenta quando precisar de uma visão geral ou quiser inspecionar formatos de registros recentes antes de editar ou criar novos.

4) wdf_data_templates_submissions_get

Use esta ferramenta quando já souber o Número do Envio e quiser o conteúdo completo e os metadados desse envio.

Entrada necessária:

  • dataTemplateId
  • submissionNumber

Caso de uso típico:

  • "Obtenha o envio 12345 do Data Template (Formulário) ABC123."

Melhor prática:

  • Se você ainda não tiver o número do envio, obtenha-o por meio de wdf_data_templates_submissions_search ou wdf_data_templates_submissions_list_recent.

5) wdf_data_templates_submissions_search

Use esta ferramenta para encontrar envios existentes por um valor de campo pesquisável.

Entrada necessária:

  • dataTemplateId
  • searchField
  • searchValue
  • opcional limit

Caso de uso típico:

  • "Encontre envios onde o nome do cliente seja Maria Souza."

Nota importante:

  • Somente campos marcados como pesquisáveis no esquema do Data Template (Formulário) podem ser usados aqui.
  • Chame wdf_data_templates_get_schema_and_sample_submissions primeiro para confirmar quais campos são pesquisáveis.

6) wdf_data_templates_submissions_create

Use esta ferramenta para criar um novo envio para um Data Template (Formulário).

Entrada necessária:

  • dataTemplateId
  • data (um objeto contendo IDs de campo e valores)

Caso de uso típico:

  • "Crie um novo envio para o Data Template (Formulário) ABC123 com estes valores."

Detalhes importantes:

  • As chaves em data devem corresponder aos IDs de campo do esquema do template, não aos rótulos de exibição.
  • Chaves não reconhecidas podem ser descartadas silenciosamente em vez de gerar um erro.
  • Inclua os campos marcados como obrigatórios no esquema; campos opcionais omitidos são simplesmente deixados em branco no novo envio.

7) wdf_data_templates_submissions_update

Use esta ferramenta para modificar um envio existente.

Entrada necessária:

  • dataTemplateId
  • submissionNumber
  • data (atualizações de campos)

Caso de uso típico:

  • "Atualize o envio 12345 e altere o campo de status."

Detalhes importantes:

  • Esta ferramenta substitui todo o objeto de dados do envio pelos valores que você fornecer; é uma sobrescrita completa, não uma mesclagem.
  • Qualquer campo existente não incluído em data será limpo para vazio.
  • Antes de chamá-la, recupere os valores atuais do envio com wdf_data_templates_submissions_get, wdf_data_templates_submissions_search ou wdf_data_templates_submissions_list_recent e inclua o conjunto completo de campos que deseja preservar junto com os que está alterando.
  • Os IDs de campo devem corresponder ao esquema do template; use a ferramenta de esquema para confirmá-los.

8) wdf_data_templates_submissions_get_workflow_meta

Use esta ferramenta antes de atualizar valores de fluxo de trabalho se você ainda não souber os valores válidos de status, prioridade, tipo e usuário.

Caso de uso típico:

  • "Quais status de fluxo de trabalho e responsáveis são válidos para este grupo?"

O que ela retorna:

  • Status de fluxo de trabalho válidos
  • Prioridades válidas
  • Tipos válidos
  • Usuários atribuíveis

Melhor prática:

  • Chame esta ferramenta antes de qualquer alteração de fluxo de trabalho se os valores válidos ainda não forem conhecidos.

9) wdf_data_templates_submissions_update_workflow

Use esta ferramenta para alterar propriedades do fluxo de trabalho, como status, prioridade, tipo e responsável, para um envio específico.

Entrada necessária:

  • dataTemplateId
  • submissionNumber
  • statusId
  • priorityId
  • typeId

Entrada opcional:

  • assigneeUserId
  • comment

Caso de uso típico:

  • "Atualize o fluxo de trabalho do envio 12345 para o status X e prioridade Y."

Detalhes importantes:

  • Esta ferramenta substitui o estado do fluxo de trabalho do envio pelos valores exatos que você fornecer; é uma sobrescrita completa, não uma atualização parcial.
  • statusId, priorityId e typeId são todos obrigatórios mesmo que apenas um esteja sendo alterado.
  • Reutilize os valores existentes do envio para qualquer campo de fluxo de trabalho que você não pretenda alterar.
  • Chame wdf_data_templates_submissions_get_workflow_meta primeiro para obter IDs válidos e recupere os valores atuais do envio primeiro (usando wdf_data_templates_submissions_get, wdf_data_templates_submissions_search ou wdf_data_templates_submissions_list_recent) se precisar preservar o estado atual do fluxo de trabalho.

Fluxo de trabalho recomendado para agentes

Um bom padrão de trabalho para um assistente de IA é:

  1. Chame wdf_data_templates_list para identificar o formulário/template disponível.
  2. Chame wdf_data_templates_get_schema_and_sample_submissions para entender os campos.
  3. Se necessário, chame wdf_data_templates_submissions_search ou wdf_data_templates_submissions_list_recent para encontrar dados existentes.
  4. Crie ou atualize envios com wdf_data_templates_submissions_create ou wdf_data_templates_submissions_update.
  5. Se houver alterações de fluxo de trabalho, chame wdf_data_templates_submissions_get_workflow_meta primeiro e depois wdf_data_templates_submissions_update_workflow.

Essa sequência ajuda a evitar nomes de campos inválidos e valores incorretos de fluxo de trabalho.

Usando este servidor MCP com Claude

Claude com o endpoint HTTP remoto

Adicionar Conector

Aponte o Claude para o servidor hospedado adicionando um novo conector personalizado:

https://mcp.webdataforms.com

Em seguida, forneça as credenciais como:

  • cabeçalhos: x-api-key e x-group-id
  • ou parâmetros de consulta se o cliente não puder enviar cabeçalhos

Adicionar Contexto

Informe ao Claude quando usar o conector Web Data Forms usando uma das opções abaixo.

Opção 1 - Criar um Projeto

Crie um novo projeto, dê a ele um nome apropriado (ex.: Assistente de Negócios). Nas instruções, informe ao Claude como o conector Web Data Forms deve ser usado para este projeto. Exemplos de instruções são fornecidos abaixo, mas adapte-os às suas necessidades.

When answering questions that may depend on company-specific information, use the connected Web Data Forms MCP connector as the authoritative source.

This includes questions concerning company policies, procedures, customers, contacts, feedback, expenses, issues, internal records, and other organization-specific information.

Do not assume that information is unavailable merely because it is not present in the current conversation. Search the connected MCP data when appropriate.

When the user asks you to record, create, update, log, or modify company information, use the appropriate MCP tool rather than merely describing what the user should do.

For questions that are clearly unrelated to the organization, do not use the MCP connector unnecessarily.

Use este projeto para realizar tarefas escrevendo ou falando naturalmente.

Opção 2 - Adicionar Instruções Específicas ao Chat

Em uma janela de chat, instrua o Claude de que ele provavelmente precisará do conector Web Data Forms para responder perguntas neste chat.

Realize tarefas escrevendo ou falando naturalmente.

Opção 3 - Instruir o Claude a Salvar Instruções na Memória de Longo Prazo

Este método pode não ser confiável neste momento.

Escreva instruções claras sobre quando usar o conector Web Data Forms e instrua o Claude a salvá-las em sua memória de longo prazo.

Realize tarefas escrevendo ou falando naturalmente.

Usando este servidor MCP com ChatGPT

Se o seu ambiente ChatGPT suportar conexões MCP, configure-o para conectar ao endpoint do servidor hospedado e passe as credenciais como cabeçalhos sempre que possível.

Configuração recomendada:

  • Use o endpoint HTTP Streamable: https://mcp.webdataforms.com
  • Adicione os cabeçalhos de autenticação x-api-key e x-group-id
  • Se o seu cliente não permitir cabeçalhos personalizados, use a abordagem alternativa de parâmetros de consulta

Exemplo de destino de conexão:

https://mcp.webdataforms.com

Padrão de uso recomendado para ChatGPT

Peça ao modelo para:

  • lembrar quais informações estão armazenadas no Web Data Forms - ex.: "Para referência futura, lembre-se de que armazeno meus contatos, despesas e problemas em aberto no Web Data Forms",
  • realizar tarefas escrevendo ou falando naturalmente - ex.: "Você pode me conseguir o número de telefone de João Silva?",

Usando este servidor MCP com OpenClaw

OpenClaw deve ser configurado para conectar ao endpoint MCP em:

https://mcp.webdataforms.com

Forneça a autenticação de uma das seguintes formas:

  1. Preferida: envie os cabeçalhos x-api-key e x-group-id
  2. Alternativa: acrescente ?x-api-key=...&x-group-id=... à URL

Se o OpenClaw suportar um objeto de configuração de servidor ou configurações de conexão, use o equivalente a:

{
  "url": "https://mcp.webdataforms.com",
  "headers": {
    "x-api-key": "your-api-key",
    "x-group-id": "your-group-id"
  }
}

Se o cliente não puder definir cabeçalhos, use a variante de parâmetro de consulta.

Usando este servidor MCP com Smithery

https://smithery.ai/servers/dotzcominc/web-data-forms

Solução de problemas

Falha na autenticação

Se você vir um erro de autenticação, verifique se:

  • x-api-key está presente e é válido
  • x-group-id está presente e é válido
  • você está usando o transporte correto
  • se o cliente não puder enviar cabeçalhos, a alternativa de parâmetro de consulta está sendo usada corretamente

Modelo ou esquema ausente

Se um ID de modelo parecer inválido:

  • liste os modelos novamente
  • verifique se você está usando o grupo correto
  • verifique se o modelo está habilitado para automação

Erros de atualização de fluxo de trabalho

Se as atualizações de fluxo de trabalho falharem:

  • chame wdf_data_templates_submissions_get_workflow_meta primeiro
  • verifique se os IDs de status/prioridade/tipo são válidos
  • confirme se o ID de usuário do responsável é válido, se fornecido

Notas de segurança

  • Nunca codifique credenciais em código-fonte ou repositórios públicos.
  • Prefira autenticação baseada em cabeçalhos em vez de parâmetros de consulta quando o cliente suportar.
  • Se você estiver implantando este servidor publicamente, garanta que o endpoint seja usado apenas por clientes confiáveis.
  • O servidor não armazena credenciais de usuário; ele as espera em cada solicitação.

Resumo rápido

A maneira mais rápida de usar este servidor MCP é:

  1. Conecte-se ao servidor com suas credenciais.
  2. Use cabeçalhos primeiro, parâmetros de consulta apenas como alternativa.
  3. Comece com wdf_data_templates_list.
  4. Inspecione o esquema com wdf_data_templates_get_schema_and_sample_submissions.
  5. Pesquise, crie, atualize ou altere o estado do fluxo de trabalho conforme necessário.