> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deepxl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistentes de IA (Claude e ChatGPT)

> Conecte o DeepXL ao Claude ou ChatGPT e verifique documentos em busca de fraude pelo chat

O DeepXL funciona como um conector [MCP](https://modelcontextprotocol.io) remoto, então você pode adicioná-lo diretamente ao **Claude** (Claude Cowork e conectores personalizados) e ao **ChatGPT** (Work). Depois de conectado, anexe um documento na conversa e pergunte se ele é fraudulento — o assistente chama o DeepXL e retorna um veredito forense real.

A URL do conector é:

```
https://mcp.deepxl.ai/mcp
```

## Conecte ao Claude

<Steps>
  <Step title="Abra as configurações de conectores">
    No Claude, vá em **Configurações → Conectores** e escolha **Adicionar conector personalizado**.
  </Step>

  <Step title="Adicione o servidor do DeepXL">
    Dê um nome (por exemplo, `DeepXL Fraud`) e defina a **URL do servidor MCP remoto** como `https://mcp.deepxl.ai/mcp`.
  </Step>

  <Step title="Faça login com sua conta DeepXL">
    Escolha **Login individual**. Uma janela do navegador abre em `clerk.deepxl.ai` — faça login com sua conta DeepXL. Não há nenhuma chave de API para colar.
  </Step>

  <Step title="Selecione sua organização">
    Quando solicitado, conceda o acesso e **selecione a organização** que deseja usar. As análises são executadas e cobradas nessa organização.
  </Step>

  <Step title="Use no chat">
    As ferramentas do DeepXL agora aparecem no Claude. Anexe um documento (ou cole uma URL) e pergunte algo como *"Este documento é fraudulento?"*
  </Step>
</Steps>

<Note>
  Conectores personalizados estão disponíveis nos planos Team, Enterprise e individuais pagos do Claude. Se você não vê **Adicionar conector personalizado**, é o seu plano do Claude, não o DeepXL.
</Note>

## Conecte ao ChatGPT

No ChatGPT Work, adicione um conector personalizado / servidor MCP apontando para `https://mcp.deepxl.ai/mcp` e conclua o mesmo fluxo de **login**. As ferramentas e o comportamento são idênticos aos do Claude.

## O que você pode fazer

O conector expõe três ferramentas:

| Ferramenta           | O que faz                                                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `analyze_document`   | Analisa um documento ou imagem em busca de fraude — envie um arquivo (até 10 MB) ou uma `source_url` (até 50 MB). Retorna um veredito de fraude. |
| `list_models`        | Lista os modelos de detecção disponíveis e os tipos de arquivo que cada um aceita.                                                               |
| `get_evidence_links` | Busca as evidências de uma detecção anterior (por que foi sinalizada e detecções relacionadas), pelo `detectionId`.                              |

Você não chama essas ferramentas diretamente — basta pedir ao assistente em linguagem natural (por ex. *"analise este extrato bancário em busca de adulteração"*) e ele escolhe a ferramenta certa.

## Créditos e cobrança

Cada análise é atribuída à **organização com a qual você fez login** e consome **um crédito** do saldo dessa organização — os mesmos créditos usados no Console e na API do DeepXL.

<Warning>
  Se sua organização ficar sem créditos, `analyze_document` retorna **`402 Payment Required`** e o assistente informará que você está sem créditos. Adicione créditos pelo [Console do DeepXL](https://console.deepxl.ai) ou entre em contato conosco e tente novamente.
</Warning>

## Solução de problemas

| Sintoma                                               | Causa e solução                                                                                                          |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| "Selecione sua organização / conceda `user:org:read`" | Você fez login sem escolher uma organização. Reconecte e selecione uma.                                                  |
| `402 Payment Required`                                | A organização não tem créditos restantes. Recarregue no Console.                                                         |
| As ferramentas não aparecem                           | O conector não terminou de conectar — remova-o e adicione novamente `https://mcp.deepxl.ai/mcp`, depois conclua o login. |

Para acesso programático sem um assistente, use a [API do DeepXL](/pt-BR/authentication) diretamente com uma chave de API.