# Sua ingestão operada por agentes de IA

> Peça a um agente para investigar uma falha, criar uma conexão ou rodar um job. Pelo MCP da Erathos, por um agente de código que monta conectores para você, ou pela API, direto do seu código.

Source: https://www.erathos.com/ai

## Converse com o seu workspace

O MCP da Erathos deixa um agente de IA, como o Claude, agir no seu workspace a partir de uma conversa: listar conexões e jobs, investigar um run com falha, escolher o que sincronizar e disparar execuções, sem passar pela interface a cada passo.

O agente só age nos workspaces que a sua conta já acessa, e cada chamada é checada contra as suas permissões reais. As credenciais ficam nos secrets do workspace, nunca na conversa.

### Diagnostique falhas

Pergunte por que um job falhou e o agente traz os logs, a linha do tempo e as métricas do run.

### Configure conexões e jobs

Crie conexões e destinos e escolha tabelas e sincronização. O agente mostra uma prévia antes de salvar.

### Orquestre o próximo passo

Dispare runs e backfills e configure webhooks que acionam o Airflow ou o dbt Cloud quando um job termina.

## Seu conector, construído por um agente de código

O template de conector customizado vem com uma skill para agentes de código. Abra o repositório no Claude Code, descreva a API que você quer conectar e o agente monta o conector para você, sem escrever YAML à mão.

Ele chama a API de verdade para montar campos, chave primária e paginação, marca o que não conseguiu verificar e roda a validação até o conector passar. Cada push é um deploy, então ele nunca faz push sem perguntar.

### Descreva a API

Diga o que precisa, como "sincronizar pedidos e clientes de forma incremental", e o agente pergunta o resto: autenticação, paginação e filtros.

### A partir de respostas reais

Campos, caminho da resposta e chave primária vêm de chamadas reais à API, não de suposições a partir da documentação.

### Validado antes do push

O agente roda a validação até passar e só faz push com a sua aprovação. O conector aparece no catálogo com o selo Custom.

## Tudo o que você faz na plataforma, também por código

A API de developer cobre o setup completo: criar conexões, configurar jobs, criar destinos e rodar jobs. Dá para provisionar ingestão a partir do seu próprio produto, de scripts ou do seu pipeline de CI.

Os jobs têm uma prévia antes de salvar, e cada conexão informa em que passo do setup está, para o seu código saber o que fazer em seguida.

### Crie conexões e destinos

Escolha o conector, envie as credenciais ou autorize via OAuth e acompanhe o setup_status até a conexão ficar pronta.

### Configure jobs com prévia

Veja tabelas, endpoints e opções de sincronização, confira a prévia e salve com dry_run: false.

### Rode e acompanhe

Dispare os jobs e acompanhe cada run pela API, com a mesma chave dos endpoints que você já usa.

## Dúvidas Frequentes

### O que é o MCP e com quais ferramentas ele funciona?

MCP (Model Context Protocol) é um padrão aberto para conectar agentes de IA a outros sistemas. O servidor MCP da Erathos funciona com clientes compatíveis com MCP, como o Claude: você adiciona o servidor ao seu cliente e se autentica com a sua conta da Erathos. O passo a passo está na [documentação do MCP](https://docs.erathos.com/platform/mcp).

### O agente vê as minhas credenciais?

Não. Para criar uma conexão, o agente devolve um link para você informar as credenciais na própria plataforma, e elas ficam nos secrets do workspace, nunca na conversa. Se quem tem as credenciais não tem conta na Erathos, o agente pode gerar um link seguro de uso único para essa pessoa.

### O agente pode fazer algo que eu não posso?

Não. Ele só age nos workspaces que a sua conta já acessa, e cada chamada é checada contra as suas permissões no momento do pedido.

### Em quais planos está o conector customizado?

O conector customizado está nos planos Pro e Enterprise. A skill para agentes de código vem no template do conector: o Claude Code a carrega sozinho, e outros agentes podem ser apontados para o arquivo da skill. Veja a [documentação de conectores customizados](https://docs.erathos.com/connectors/custom-connectors).

### Como eu me autentico na API?

Com uma chave de API da Erathos, enviada no header Authorization. A chave age como o usuário dono dela: cada pedido só pode fazer o que esse usuário já pode fazer no workspace.