O Codex, o Cursor, o VS Code com GitHub Copilot, o Claude Code e o Claude ligam-se ao mesmo servidor MCP do Entity Enricher. Os seus agentes podem desenhar esquemas, enriquecer entidades em várias línguas, fundir modelos, curar identidades semânticas, avaliar a qualidade com benchmarks, sincronizar tabelas relacionais com uma base de dados — nos modelos da plataforma ou no modelo do próprio cliente, quando o trabalho delega as suas chamadas LLM — e perguntar ao assistente de suporte do produto quando a questão é sobre o próprio Entity Enricher.
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.
Por predefinição, todas as ferramentas de início executam a sua tarefa no seu próprio modelo (com use_platform_models=true, ou indicando um modelo de plataforma, passa a correr nos modelos faturados da plataforma). A tarefa não faz nenhuma chamada a modelos da plataforma e não gasta créditos: o modelo por trás do seu cliente MCP — o que já tem a sua conversa, os seus documentos e as suas ferramentas ligadas — responde a todas as chamadas de modelo da tarefa, e a plataforma fica com aquilo em que é boa: construir os prompts, aplicar o esquema de saída, validar e normalizar cada resposta, guardar os registos e sincronizar as bases de dados.
enable_web_search onde a ferramenta o aceita: se for omitido, devolve web_search_undecided para que pergunte primeiro ao utilizador, já que a pesquisa seria sua. A tarefa fica em pausa assim que a sua primeira chamada de modelo estiver pronta.llm_requests no estado da tarefa: cada entrada corresponde a uma chamada ao modelo no formato MCP sampling/createMessage — prompt de sistema, mensagens, ferramentas e toolChoice — com um purpose que identifica o passo e um prazo. Os anexos binários são referenciados como recursosenricher://attachments/{id}, nunca incluídos diretamente; o texto extraído já está nas mensagens. Um cliente que carregou o ficheiro lê a sua própria cópia, pelo que um anexo nunca exige um modelo da plataforma.answer_llm_request. A plataforma valida-o em relação ao esquema exatamente como valida a resposta de um fornecedor; uma resposta rejeitada regressa como a mesma conversa, com o erro num tool result falhado, para corrigir e responder de novo.Os detalhes do protocolo e os casos-limite — a exclusão, a decisão sobre a pesquisa web, os pedidos concorrentes, os pedidos de correção no enriquecimento, os anexos, os tempos de espera — estão no guia Chamadas LLM delegadas indicado abaixo.
O OAuth permite que um cliente se ligue sem chave de API. O ecrã de consentimento do Entity Enricher identifica o cliente, a organização e a função concedida à ligação. O acesso pode ser gerido ou revogado em Chaves de API → Aplicações ligadas.
Estes exemplos utilizam o início de sessão no navegador (OAuth) e o mesmo endpoint Streamable HTTP: https://entityenricher.ai/api/mcp/, incluindo a barra final. Cada cliente tem o seu próprio formato de configuração.
O Codex partilha as definições MCP entre a aplicação, a CLI e a extensão de IDE através de ~/.codex/config.toml. O primeiro comando regista o Entity Enricher; o comando de início de sessão abre a autenticação no navegador sempre que esta é necessária.
codex mcp add entity-enricher --url https://entityenricher.ai/api/mcp/
codex mcp login entity-enricherO Cursor lê os servidores do projeto em .cursor/mcp.json ou os servidores pessoais em ~/.cursor/mcp.json. A entrada do servidor remoto utiliza mcpServers; o Cursor trata do fluxo de início de sessão OAuth.
{
"mcpServers": {
"entity-enricher": {
"url": "https://entityenricher.ai/api/mcp/"
}
}
}O VS Code utiliza .vscode/mcp.json com um objeto servers e um transporte http explícito. Ao iniciar o servidor, as suas ferramentas ficam disponíveis para o agente do GitHub Copilot após a autorização.
{
"servers": {
"entity-enricher": {
"type": "http",
"url": "https://entityenricher.ai/api/mcp/"
}
}
}Este comando regista um servidor HTTP remoto no Claude Code. O comando /mcp dentro do Claude Code abre os controlos de ligação e de autenticação.
claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/No claude.ai e no Claude Desktop, as definições de Conectores oferecem a ação "Adicionar conector personalizado". O conector utiliza o URL do servidor indicado acima e abre o ecrã de autorização do Entity Enricher. Esta ligação alojada é configurada através de Conectores; o ficheiro claude_desktop_config.json destina-se a servidores locais.
As chaves de acesso da organização são criadas em Definições → Chaves de API com uma função à escolha. Os clientes podem enviar a chave num cabeçalho X-API-Key em vez de iniciarem sessão com OAuth. Por exemplo, esta configuração do Codex lê a chave a partir de uma variável de ambiente:
[mcp_servers.entity-enricher]
url = "https://entityenricher.ai/api/mcp/"
env_http_headers = { "X-API-Key" = "ENTITY_ENRICHER_API_KEY" }ENTITY_ENRICHER_API_KEY deve conter a chave no ambiente do processo que executa o Codex. O Cursor e o VS Code aceitam este cabeçalho HTTP no respetivo objeto de configuração headers. As referências de cliente acima descrevem as definições suportadas.
O mesmo pedido funciona em qualquer cliente: "Liste os meus schemas do Entity Enricher, depois enriqueça a Sanofi com o meu schema de empresa farmacêutica e mostre o resultado guardado."O cliente descobre as ferramentas e utiliza-as para selecionar um schema e executar o enriquecimento. Os pedidos de confirmação, a apresentação do progresso e o acesso aos recursos dependem do cliente.
As 62 ferramentas abrangem a criação de esquemas, enriquecimento, benchmarks, database sync, identidades semânticas e suporte ao produto. Reutilizam 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. Inspecione as falhas e os resultados parciais antes de comunicar 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 | Materializar uma região de entidade a partir do x-entityMap de get_schema. |
| 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 | 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. |
| Controlo de tarefas | answer_llm_request | Submeta o resultado de uma chamada de modelo pendente de uma tarefa delegada: uma tarefa que o utilizador iniciou no modelo do próprio cliente (a predefinição de todas as ferramentas de início, exceto se use_platform_models=true ou um… |
| 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 | revert_benchmark_reference_updates | Anule as edições automáticas que uma passagem de pontuação fez à referência de um cenário. |
| 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 | get_database_setup_instructions | Devolve instruções não secretas de instalação, de emparelhamento confirmado no browser e de execução para um cliente de ee-database sync. |
| 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. |
| Suporte ao produto | ask_support | Coloque uma questão ao Rupert, o assistente de suporte ao produto do Entity Enricher, sobre a própria aplicação: como funciona uma funcionalidade, uma ferramenta ou uma definição, o que significa um error_code, um limite, um estado… |
| Suporte ao produto | get_support_conversation | Leia um dos seus tópicos de suporte com todos os turnos: as suas perguntas (role user), as respostas do Rupert (assistant) e as respostas de seguimento da equipa de suporte (admin, com author_name). |
| Suporte ao produto | list_support_conversations | Os seus tópicos de suporte, com a atividade mais recente primeiro, com message_count e unread_for_user (uma resposta de seguimento da equipa de suporte que ainda não leu). |
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.
Por predefinição, todos os trabalhos que inicia são executados no seu próprio modelo: responda a cada uma das respetivas chamadas de modelo com `answer_llm_request` e deixe a plataforma validar cada resposta em relação ao esquema. `use_platform_models=true` executa o trabalho na plataforma, no modelo com melhor benchmark da organização para essa tarefa.
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.
Coloque ao Rupert, o assistente de suporte ao produto, qualquer questão sobre o próprio Entity Enricher, continue o tópico que abriu e leia as respostas de seguimento da equipa de suporte.
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. |
| enricher://attachments/{attachment_id} | Os bytes de um anexo carregado, servidos com o seu tipo de media real — é assim que uma tarefa que delega as suas chamadas ao LLM entrega ao seu cliente um ficheiro PDF, de imagem ou de áudio que este não carregou. |
Quando uma questão é sobre o próprio Entity Enricher — como funciona uma funcionalidade ou uma ferramenta, o que significa um código de erro, um limite ou um aviso, porque é que um resultado tem determinado aspeto — e os guias não respondem, as instruções do servidor dizem ao agente para perguntar ao Rupert, o assistente de suporte do produto, com ask_support em vez de adivinhar. A chamada devolve a resposta completa e o id do tópico que abriu; passar esseconversation_id à pergunta seguinte mantém o contexto da troca.
Cada pergunta é descontada da quota diária de suporte da organização, indicada emquestions_remaining. A equipa de suporte pode responder no tópico: o próximo ask_support nesse tópico devolve essas respostas emnew_admin_messages, eget_support_conversation lê um tópico completo. Os mesmos tópicos aparecem no chat de suporte da aplicação web e, para os proprietários, no separador Discussões da página Utilizadores, marcados como abertos por um agente de IA.
Quando pede a enrich_entity para usar um modelo de classificação e a entity não corresponde ao tipo do schema, a ferramenta devolve uma resposta sem erro com detalhes estruturados. O cliente lê-a, apresenta-lhe o raciocínio e (após a sua confirmação) tenta novamente com force_after_classification_warning=true — o que dispensa o classificador nessa 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 suporta um segundo fluxo: quando generate_sample é executado com documentos de origem, o respetivo planeador pode pausar com perguntas de clarificação estrutural. O cliente encaminha-as para você e retoma a tarefa 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 prévio rejeitou a entidade. A resposta inclui o contexto de classificação para que o cliente possa pedir confirmação ao utilizador e tentar 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. |
| support_question_limit_reached | A quota diária de perguntas de suporte da organização está esgotada (HTTP 402). O corpo inclui limit e used; cada resultado de ask_support indica questions_remaining. |
| support_requires_user | ask_support foi chamada com uma chave de acesso de organização (HTTP 403). Um tópico de suporte pertence a uma pessoa: inicie sessão com OAuth ou com uma chave de API pessoal. |
| support_unavailable | O assistente de suporte não conseguiu responder (falha de encaminhamento). A pergunta continua a ser contabilizada e o tópico existe: leia-o mais tarde com get_support_conversation em vez de perguntar outra vez de imediato. |
| web_search_undecided | Uma ferramenta de início foi chamada sem enable_web_search para uma tarefa a correr no seu modelo. Pergunte ao utilizador se o seu modelo pode usar a pesquisa web e volte a chamá-la com enable_web_search=true ou false. |
| delegation_requires_auto | Uma tarefa a correr no seu modelo encontrou um modelo de plataforma explícito injetado após o início, como uma predefinição da organização (HTTP 400). Inicie a tarefa com use_platform_models=true ou elimine essa predefinição. |
| request_not_pending | answer_llm_request indicou um pedido que já foi respondido, expirou ou pertence a uma tarefa que entretanto avançou. Consulte get_job_status(job_id).llm_requests para saber o que está pendente agora. |
| llm_request_pending | answer_job_question foi chamado numa tarefa pausada em pedidos LLM delegados, não numa pergunta. Responda-lhes com answer_llm_request. |
| llm_request_timeout | Uma tarefa que delega as suas chamadas LLM não recebeu resposta a um pedido pendente no prazo de 15 minutos; a tarefa falhou. As tarefas delegadas não têm resposta predefinida. |
| 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.