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.

GitHub

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 John Smith."
"Crie uma nova solicitação de suporte."
"Mostre-me 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 (sem estado). 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.

O que este servidor pode fazer

Este servidor expõe as seguintes ferramentas:

wdf_data_templates_list — lista os Data Templates (Forms) com automação habilitada disponíveis para o grupo atual, para que você possa identificar o Data Template (Form) 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 os envios recentes de um Data Template (Form) 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 explicitamente marcados como pesquisáveis no Data Template (Form).
wdf_data_templates_submissions_create — cria um novo envio para um Data Template (Form) usando os IDs de campos do schema.
wdf_data_templates_submissions_update — atualiza um envio existente, com a ressalva de que substitui o objeto de dados do envio inteiro 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 de 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 API Key do Web Data Forms
x-group-id — seu Group ID do Web Data Forms

Você pode encontrá-los na página group→information 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 somente 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 conseguir enviar cabeçalhos personalizados, use o método alternativo de parâmetros de consulta descrito acima.

Opções de transporte

Este servidor foi projetado atualmente para uso remoto via Streamable HTTP.

Transporte remoto Streamable HTTP

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

O endpoint HTTP é:

https://mcp.webdataforms.com

Como se 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 (Forms) com automação habilitada estão disponíveis no grupo atual.

Caso de uso típico:

"Liste os Data Templates (Forms) disponíveis no meu grupo."
"Mostre-me os Data Templates (Forms) com os quais posso trabalhar."

O que ela retorna:

Uma lista dos Data Templates (Forms) disponíveis para o grupo ativo.

Melhor prática:

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

2) `wdf_data_templates_get_schema_and_sample_submissions`

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

Entrada necessária:

dataTemplateId

O que ela retorna:

Os campos do formulário, incluindo seus field IDs
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:

Use esta ferramenta sempre antes de criar um novo envio, se precisar saber quais campos são obrigatórios ou suportados.
Os field IDs 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 (Form) quando não precisar de uma pesquisa direcionada.

Entrada necessária:

dataTemplateId
opcional: limit

Caso de uso típico:

"Mostre-me os últimos 10 envios deste Data Template (Form)."

Melhor prática:

Use esta ferramenta quando precisar de uma visão geral ou quiser inspecionar os 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 obter 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 (Form) 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 em que o nome do cliente seja Jane Doe."

Observação importante:

Somente campos marcados como pesquisáveis no schema do Data Template (Form) 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 (Form).

Entrada necessária:

dataTemplateId
data (um objeto contendo field IDs e valores)

Caso de uso típico:

"Crie um novo envio para o Data Template (Form) ABC123 com estes valores."

Detalhes importantes:

As chaves em data devem corresponder aos field IDs do schema do template, não aos rótulos de exibição.
Chaves não reconhecidas podem ser silenciosamente descartadas em vez de gerar um erro.
Inclua os campos marcados como obrigatórios no schema; 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 o objeto de dados inteiro 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 (esvaziado).
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 field IDs devem corresponder ao schema do template; use a ferramenta de schema 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 de fluxo de trabalho, como status, prioridade, tipo e responsável de 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 a prioridade Y."

Detalhes importantes:

Esta ferramenta substitui o estado de 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 de fluxo de trabalho existente.

Fluxo de trabalho recomendado para agentes

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

Chame wdf_data_templates_list para identificar o formulário/template disponível.
Chame wdf_data_templates_get_schema_and_sample_submissions para entender os campos.
Se necessário, chame wdf_data_templates_submissions_search ou wdf_data_templates_submissions_list_recent para encontrar dados existentes.
Crie ou atualize envios com wdf_data_templates_submissions_create ou wdf_data_templates_submissions_update.
Se houver alterações de fluxo de trabalho envolvidas, 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.

Como usar este servidor MCP com Claude

Claude com o endpoint HTTP remoto

Aponte o Claude para o servidor hospedado em:

https://mcp.webdataforms.com

Depois 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

Padrão de uso recomendado com Claude

Peça ao Claude para:

lembrar quais informações estão armazenadas no Web Data Forms — por exemplo: "Para referência futura, lembre-se de que eu armazeno meus contatos, despesas e problemas em aberto no Web Data Forms",
executar tarefas escrevendo ou falando naturalmente — por exemplo: "Você consegue me trazer o telefone do John Smith?",

Como usar este servidor MCP com ChatGPT

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

Configuração recomendada:

Use o endpoint Streamable HTTP: 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 com ChatGPT

Peça ao modelo para:

lembrar quais informações estão armazenadas no Web Data Forms — por exemplo: "Para referência futura, lembre-se de que eu armazeno meus contatos, despesas e problemas em aberto no Web Data Forms",
executar tarefas escrevendo ou falando naturalmente — por exemplo: "Você consegue me trazer o telefone do John Smith?",

Como usar este servidor MCP com OpenClaw

O OpenClaw deve ser configurado para se conectar ao endpoint MCP em:

https://mcp.webdataforms.com

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

Preferido: envie os cabeçalhos x-api-key e x-group-id
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 com parâmetros de consulta.

Como usar 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, o método alternativo de parâmetros de consulta está sendo usado corretamente

Template ou schema ausente

Se um template ID parecer inválido:

liste os templates novamente
verifique se você está usando o grupo correto
verifique se o template está com automação habilitada

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 do usuário responsável é válido, se fornecido

Notas de segurança

Nunca codifique credenciais diretamente no código-fonte ou em 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 requisição.

Resumo rápido

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

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

Web Data Forms

Documentação

Instruções do Servidor MCP Web Data Forms

O que este servidor pode fazer

Configuração

Credenciais necessárias

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

Método alternativo: parâmetros de consulta

Modelo de implantação atual

Opções de transporte

Transporte remoto Streamable HTTP

Como se conectar ao servidor

Conexão somente remota

Ferramentas

1) wdf_data_templates_list

2) wdf_data_templates_get_schema_and_sample_submissions

3) wdf_data_templates_submissions_list_recent

4) wdf_data_templates_submissions_get

5) wdf_data_templates_submissions_search

6) wdf_data_templates_submissions_create

7) wdf_data_templates_submissions_update

8) wdf_data_templates_submissions_get_workflow_meta

9) wdf_data_templates_submissions_update_workflow

Fluxo de trabalho recomendado para agentes

Como usar este servidor MCP com Claude

Claude com o endpoint HTTP remoto

Padrão de uso recomendado com Claude

Como usar este servidor MCP com ChatGPT

Padrão de uso recomendado com ChatGPT

Como usar este servidor MCP com OpenClaw

Como usar este servidor MCP com Smithery

Solução de problemas

Falha na autenticação

Template ou schema ausente

Erros de atualização de fluxo de trabalho

Notas de segurança

Resumo rápido

1) `wdf_data_templates_list`

2) `wdf_data_templates_get_schema_and_sample_submissions`

3) `wdf_data_templates_submissions_list_recent`

4) `wdf_data_templates_submissions_get`

5) `wdf_data_templates_submissions_search`

6) `wdf_data_templates_submissions_create`

7) `wdf_data_templates_submissions_update`

8) `wdf_data_templates_submissions_get_workflow_meta`

9) `wdf_data_templates_submissions_update_workflow`