Utilize o Entity Enricher a partir de um cliente compatível com MCP para transformar o conhecimento dos modelos e os seus documentos em dados estruturados. Crie esquemas, enriqueça entidades em várias línguas, faça a fusão de modelos, faça a curadoria de identidades semânticas, avalie a qualidade com benchmarks e sincronize tabelas relacionais com a sua própria base de dados.
A validação do esquema e a concordância entre modelos não garantem a exatidão factual nem a atualidade dos dados. Analise as fontes, as falhas e os resultados parciais na base de dados. O MCP disponibiliza acesso conversacional; o n8n e o Make disponibilizam automação de fluxos de trabalho sobre o mesmo serviço.
Para claude.ai, Claude Code, Cursor e qualquer cliente MCP que suporte o fluxo OAuth padrão. Sem chave de API para criar ou colar — o cliente deteta o servidor de autorização automaticamente.
https://entityenricher.ai/api/mcp/.Para clientes configurados através de um ficheiro JSON em vez de um início de sessão interativo (Claude Desktop, Continue, Zed).
ent_… — só é mostrado uma vez.Para Claude Desktop, edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"entityenricher": {
"url": "https://entityenricher.ai/api/mcp/",
"headers": { "X-API-Key": "ent_your_key_here" }
}
}
}Utilize o endpoint e o cabeçalho acima na configuração de MCP remoto do seu cliente. A sintaxe de configuração e o suporte do transporte HTTP dependem do cliente.
Num novo chat: "Liste os meus esquemas do Entity Enricher e depois enriqueça a Sanofi com o esquema de empresa farmacêutica utilizando o Claude Sonnet."O cliente pode descobrir as ferramentas e utilizá-las para selecionar um esquema e executar o enriquecimento. Os pedidos de confirmação, a apresentação do progresso e o acesso aos recursos dependem do cliente.
58 ferramentas abrangem a criação de esquemas, o enriquecimento, os benchmarks, o Database Sync e as identidades semânticas. Reutilizam os serviços de backend para validação, faturação e processamento. Cada ferramenta expõe os seus próprios parâmetros suportados. O trabalho de longa duração (enriquecimento em lote, geração de amostras, execuções de benchmark) é assíncrono: a ferramenta de arranque devolve um job_id, o cliente consulta get_job_statuse lê os registos resultantes ou os resultados do benchmark. Analise as falhas e os resultados parciais antes de reportar sucesso.
| Categoria | Ferramenta | Descrição |
|---|---|---|
| Descoberta | list_models | Liste as chaves de modelo disponíveis, as capacidades nominais, os idiomas, as estratégias, as predefinições selecionadas automaticamente e os profile_limits da organização. |
| Esquemas | generate_sample | Gere JSON de amostra editável a partir de um pedido em texto livre para a criação de esquemas. |
| Esquemas | list_schemas | Liste os schemas guardados na sua organização, começando pelos fixados. |
| Esquemas | get_schema | Consulte um schema guardado com as suas propriedades, anotações e input_contract. |
| Esquemas | create_schema_from_sample | Gere e guarde automaticamente um esquema a partir de amostras revistas, devolvendo schema_id, o conteúdo do esquema e as ligações aos registos. |
| Esquemas | save_schema | Guarde um esquema escrito diretamente e devolva o respetivo ID e link. |
| Esquemas | update_schema | Edite os metadados de um esquema guardado ou substitua todo o seu schema_content sem uma chamada ao LLM. |
| Esquemas | get_schema_part | Leia apenas o fragmento de schema necessário para uma edição. |
| Esquemas | get_enum_candidates | Liste os valores observados fora do vocabulário atual de cada enum aberto, com contagens dos registos de enriquecimento recentes. |
| Esquemas | update_schema_property | Edite ou remova uma propriedade por caminho sem substituir o esquema completo. |
| Esquemas | add_schema_property | Adicione uma propriedade sob a raiz (parent_path='), num caminho de objeto ou em '$defs.X'. |
| Esquemas | move_schema_property | Mova uma propriedade para a raiz, para um caminho de objeto ou para '$defs.X', preservando as suas flags e a sua especialidade. |
| Esquemas | resolve_unify_proposal | Resolva uma proposta pendente de unificação de tipos de entidade proveniente de get_schema. |
| Esquemas | nest_schema_region | Aninhe uma região de entidade plana do x-entityMap de get_schema num subobjeto do objeto que contém os seus campos: os membros planos da região (por exemplo, product_id, product_name numa encomenda… |
| Esquemas | publish_schema | Publique a cópia de trabalho de um schema associado a uma base de dados como o contrato usado pelo enriquecimento e pelas réplicas. |
| Esquemas | delete_schema | Elimine (soft delete) um esquema guardado por UUID. |
| Esquemas | analyze_sample | Analise a ambiguidade das propriedades da amostra e o âmbito de identidade das relações antes da geração do esquema. |
| Esquemas | analyze_schema | Analise a ambiguidade das propriedades e o âmbito de identidade das relações de um esquema guardado, escrevendo anotações no esquema. |
| Enriquecimento e fusão | start_batch_enrichment | Inicie o enriquecimento assíncrono faturado de uma lista de entidades com exatamente um de schema_id ou target_schema. |
| Enriquecimento e fusão | fetch_entities | Obtenha entidades a partir de uma API REST externa através de um GET do lado do servidor. |
| Enriquecimento e fusão | enrich_entity | Enriqueça uma entidade com exatamente um de schema_id ou target_schema, devolvendo saída estruturada, record_id, custos e qualquer resultado na base de dados. |
| Enriquecimento e fusão | retry_expertises | Repita apenas os domínios de especialidade falhados de um registo existente, atualizando depois o respetivo output e tentando a fusão/sincronização da execução. |
| Enriquecimento e fusão | merge_records | Funda dois ou mais registos da mesma entidade num novo registo de arbitragem. |
| Controlo de tarefas | get_job_status | Consulte o estado, o progresso e o resumo final compacto de uma tarefa, com os IDs dos registos persistidos. |
| Controlo de tarefas | cancel_job | Solicite o cancelamento de uma tarefa LLM pendente, em execução ou em pausa. |
| Controlo de tarefas | answer_job_question | Retome uma tarefa em pausa com as respostas às perguntas devolvidas durante a pausa. |
| Registos e estatísticas | list_records | Liste os registos da sua organização de forma compacta e paginada, dos mais recentes para os mais antigos. |
| Registos e estatísticas | get_record | Consulte o structured_output, o entity_input_data, os erros de validação, os veredictos de especialidade e as métricas de um registo persistido. |
| Registos e estatísticas | get_stats | Consulte os totais de registos, a taxa de sucesso, os tokens e o resumo de custos de toda a organização. |
| Benchmarks | list_benchmark_scenarios | Liste resumos compactos dos cenários de benchmark e o total. |
| Benchmarks | get_benchmark_scenario | Consulte um cenário de benchmark com os resultados de qualidade, custo e velocidade por modelo. |
| Benchmarks | get_benchmark_scenario_results | Filtre, ordene e limite os resultados de benchmark por modelo de um cenário. |
| Benchmarks | create_benchmark_scenario | Crie um benchmark reutilizável com um avaliador de pontuação obrigatório. |
| Benchmarks | update_benchmark_scenario | Edite a definição de teste ou a configuração de pontuação de um benchmark. |
| Benchmarks | set_benchmark_reference | Guarde a referência gold de um benchmark de enriquecimento ou de geração de esquemas. |
| Benchmarks | delete_benchmark_scenario | Elimine um cenário de benchmark e os respetivos resultados guardados. |
| Benchmarks | run_benchmark | Inicie a execução e a pontuação assíncronas e faturadas de um benchmark. |
| Anexos | upload_attachment | Carregue os bytes de um ficheiro em base64 como material de origem reutilizável; devolve id e requires_capability. |
| Anexos | delete_attachment | Elimine permanentemente um anexo da sua organização, incluindo o respetivo ficheiro armazenado. |
| Database Sync | list_database_syncs | Liste as inscrições em base de dados, os schemas associados, as opções e os anfitriões de sincronização de um schema guardado. |
| Database Sync | list_entity_states | Consulte as linhas de entidades combinadas atuais de um esquema, e não os registos por execução. |
| Database Sync | create_database_sync | Registe um schema guardado para sincronização relacional com PostgreSQL, MySQL ou SQLite. |
| Database Sync | assign_sync_host | Atribua ou remova o anfitrião que aprovisiona um Database Sync. |
| Database Sync | classify_database_model | Inicie uma análise faturada que propõe chaves de base de dados, tipos SQL, índices e a titularidade das relações num esquema associado. |
| Database Sync | delete_database_sync | Elimine um registo de base de dados e os respetivos deltas em fila, interrompendo o seu fluxo. |
| Database Sync | create_database_credential | Emita uma credencial de utilização única para o cliente de sincronização, com sugestões de comandos de instalação/emparelhamento/execução. |
| Database Sync | fetch_database_deltas | Leia a janela ordenada seguinte de deltas SQL e de payloads canónicos de uma sincronização de base de dados. |
| Database Sync | ack_database_deltas | Confirme cada delta até up_to_id após a aplicação bem-sucedida, libertando a respetiva lease. |
| Database Sync | sync_records_to_database | Valide e injete resultados de enriquecimento armazenados ou fornecidos na camada de entidades e nas sincronizações associadas. |
| IDs semânticos | list_semantic_concepts | Consulte os conceitos da organização com aliases, contagens de utilização e facetas de tipo/modelo. |
| IDs semânticos | get_semantic_concept | Consulte os aliases, as chaves de identidade de origem, os registos associados e os vizinhos mais próximos de um conceito dentro da sua própria fatia de tipo/modelo. |
| IDs semânticos | probe_semantic_concept | Pré-visualize a resolução de identidade sem adicionar um conceito nem aumentar a respetiva utilização. |
| IDs semânticos | add_semantic_concept | Adicione um conceito de identidade com utilização zero, ou adicione texto como alias através de alias_of. |
| IDs semânticos | update_concept_alias | Remova ou promova um alias de conceito usando os IDs de alias obtidos em get_semantic_concept. |
| IDs semânticos | import_semantic_concepts | Resolva 1..1000 textos face a um tipo de conceito. |
| IDs semânticos | merge_semantic_concepts | Funda um conceito perdedor num conceito vencedor. |
| IDs semânticos | delete_semantic_concepts | Elimine conceitos selecionados por ids, concept_types ou unused_only. |
| IDs semânticos | migrate_semantic_embeddings | Inspecione ou migre o espaço de embeddings de conceitos da organização. |
As instruções do servidor explicam os fluxos de trabalho disponíveis; as descrições das ferramentas explicam cada chamada. Para decisões de modelação ou de recuperação, o seu cliente pode consultar o índice de guias em enricher://docs e selecionar um guia através dos recursos MCP. Ler um guia não executa qualquer modelo. As ligações abaixo abrem os mesmos guias, em inglês, no repositório público.
Conceba um esquema reutilizável a partir de exemplos revistos, incluindo identidade, relações e campos multilingues.
Leia, crie e edite documentos de schema do Entity Enricher sem confundir JSON Schema serializado, dados de exemplo e caminhos das ferramentas de propriedades.
Escolha extração, enriquecimento por conhecimento ou uma combinação em duas passagens, e preserve a proveniência dos anexos entre chamadas.
Enriqueça uma entidade, interprete o resultado real e recupere falhas parciais de modelos sem repetir o trabalho bem-sucedido.
Enriqueça uma lista de entidades de forma assíncrona e distinga os resultados ignorados, falhados, fundidos e admitidos na base de dados.
Compare modelos em enriquecimento, geração de amostras ou geração de esquemas, utilizando a referência e a interpretação de pontuação corretas.
Transforme esquemas de enriquecimento em tabelas relacionais na sua própria base de dados e verifique separadamente a admissão, a migração e a entrega das réplicas.
Reconheça entidades recorrentes em diferentes formas de superfície, reveja correspondências incertas e perceba como as alterações de vocabulário afetam as réplicas.
Os recursos expõem dados de schema e de registos, bem como guias de fluxo de trabalho, em Markdown. Os clientes escolhem como os descobrir e carregar; ainda assim, o conteúdo dos recursos pode consumir contexto do modelo.
| Modelo de URI | Descrição |
|---|---|
| enricher://docs | Índice dos guias de fluxo de trabalho, cada um disponível no URI de recurso indicado. |
| enricher://schemas/{schema_id} | Uma cópia de trabalho de um esquema guardado em Markdown; utilize get_schema com version="published" para obter o contrato ativo associado. |
| enricher://records/{record_id} | Um registo de enriquecimento anterior apresentado em Markdown — metadados + saída estruturada + erros de validação. |
Quando pede à enrich_entity para utilizar um classification model e a entity não corresponde ao tipo do schema, a ferramenta devolve uma resposta sem erro com detalhes estruturados. O Claude lê-a, apresenta-lhe o raciocínio e (após a sua confirmação) repete com force_after_classification_warning=true — o que remove o classificador na nova tentativa.
{
"success": false,
"error_code": "classification_warning",
"message": "Pre-flight classification rejected the entity. ...",
"classification": {
"status": "mismatch",
"reasoning": "Titan is a moon of Saturn, not a planet.",
"confidence": 0.97
},
"job_id": "..."
}A resposta do MCP preserva os detalhes da classificação, para que o seu cliente possa explicar a decisão antes de iniciar uma nova chamada.
A mesma interatividade alimenta um segundo fluxo: quando o generate_sample é executado com documentos de origem, o seu planeador pode pausar com perguntas de esclarecimento estruturais. O Claude transmite-as e retoma o trabalho com answer_job_question — ronda após ronda, até a amostra ser gerada.
A maioria dos erros de ferramentas devolve um objeto estruturado com um campo error_code, para que o cliente consiga distinguir falhas de quota, de classificação, de tempo limite e do fornecedor. Algumas respostas mais antigas incluem apenas um campo error ou message; inspecione o resultado propriamente dito, além do estado do transporte.
| error_code | Quando |
|---|---|
| invalid_request | UUID malformado, argumentos mutuamente exclusivos (schema_id + target_schema) ou falha na validação do corpo do pedido. |
| prompt_limit_reached | Quota de prompts diária / semanal / mensal esgotada (HTTP 402). O corpo inclui período, limite, utilizado e necessário. |
| insufficient_credits | A org tem a faturação ativada, mas o saldo de credits é demasiado baixo para iniciar o trabalho (HTTP 402). O corpo inclui o saldo e um URL de compra. |
| model_limit_exceeded | Foram pedidos mais modelos do que o plano permite (HTTP 402). Devolve o limite + o solicitado. |
| language_limit_exceeded | Foram pedidos mais idiomas do que o plano permite (HTTP 402). |
| concurrent_job_limit_reached | Demasiadas tarefas de enriquecimento ativas para esta organização. Aguarde ou atualize o plano. |
| classification_warning | ⚡ Não é um erro: o classificador de pré-verificação rejeitou a entidade. A resposta inclui o contexto da classificação para que o Claude possa pedir ao utilizador que confirme e tente novamente com force_after_classification_warning=true. |
| benchmarks_not_in_plan | O plano da organização não inclui os Benchmarks de Modelos (HTTP 403). As ferramentas de benchmark que alteram dados verificam também o papel de proprietário. |
| ambiguity_check_disabled | analyze_schema foi chamado num esquema cuja verificação de ambiguidade está desativada (HTTP 400). Reative-a primeiro através de update_schema com ambiguity_check_enabled=true. |
| enrichment_timeout | A tarefa excedeu timeout_seconds. Sugira menos models ou dividir a entity. |
| schema_generation_timeout | A geração de esquemas excedeu o timeout_seconds. |
| schema_generation_failed | Erro do LLM a montante durante a geração do schema (HTTP 502). |
| model_output_invalid | O modelo devolveu um resultado que não corresponde ao schema (HTTP 502). O corpo indica o modelo, o caminho da propriedade em causa e retryable: true — chame novamente a ferramenta ou escolha um modelo mais forte. |
| cancelled | A tarefa foi cancelada a meio da execução (HTTP 499). |
| not_found | O ID do esquema ou do registo não existe na sua organização. |
| http_error | Genérico para erros HTTP sem um corpo de detalhe estruturado. |
get_stats abrange os resumos do lado do chat; os painéis completos permanecem na aplicação.