Docspeed

npx add-mcp 'https://api.docspeed.ai/mcp/'

Seu agente. Ferramentas de documentos Docspeed.

Leia e estruture documentos, extraia campos e tabelas, faça perguntas com citações, compare evidências documentais ou crie um fluxo de trabalho reutilizável com o Docster dentro do agente que você já usa.

Crie uma conta Conecte seu agente

Novas contas criadas diretamente com o Docspeed começam com 10 créditos de saldo de API. Crie uma chave de API no seu painel para usá-la. Recargas pagas não estão disponíveis no momento.

Conexão MCP nativa + skill complementar · Sem ZIP ou Python necessário

Registro oficial do MCP Registry: ai.docspeed/docspeed · 0.1.0 (JSON). Instale e conecte abaixo; uma listagem no registry não instala nem habilita ferramentas automaticamente no seu cliente.

Conecte agora — sem ZIP ou Python necessário

Crie sua conta e chave de API. Abra seu projeto de documentos em um terminal macOS ou Linux usando Bash ou zsh. Execute este bloco, cole a chave no prompt oculto e pressione Enter:

printf 'Docspeed API key (input hidden): '
read -r -s DOCSPEED_API_KEY
printf '\n'
export DOCSPEED_API_KEY

A chave permanece no ambiente deste terminal, fora do histórico de comandos e da configuração do MCP. Mantenha este terminal aberto para instalação e inicialização; repita o prompt oculto em um novo terminal. Não cole a chave em chats ou arquivos compartilhados. Um aplicativo de desktop iniciado separadamente não herda automaticamente a chave deste terminal; estes passos iniciam os clientes de terminal.

Abra um terminal no seu projeto de documentos. Escolha seu cliente instalado e cole o comando dele. Ele adiciona a conexão MCP nativa e busca a skill complementar diretamente. Já personalizou essa skill? Preserve-a e use as verificações de conflito do instalador ZIP.

Codex

codex mcp add docspeed --url https://api.docspeed.ai/mcp/ --bearer-token-env-var DOCSPEED_API_KEY && \
mkdir -p .agents/skills/docspeed-documents/agents .agents/skills/docspeed-documents/scripts && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/SKILL.md -o .agents/skills/docspeed-documents/SKILL.md && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/agents/openai.yaml -o .agents/skills/docspeed-documents/agents/openai.yaml && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/scripts/upload.py -o .agents/skills/docspeed-documents/scripts/upload.py

O Codex registra o servidor MCP na sua configuração de usuário e a skill neste projeto. No mesmo terminal, inicie uma nova sessão aqui:

codex -c mcp_servers.docspeed.tool_timeout_sec=1200

O timeout preserva as permissões normais. Para uso recorrente, defina tool_timeout_sec = 1200 na tabela do servidor Docspeed abaixo.

Claude Code

claude mcp add --transport http --scope project docspeed https://api.docspeed.ai/mcp/ --header 'Authorization: Bearer ${DOCSPEED_API_KEY}' && \
mkdir -p .claude/skills/docspeed-documents/scripts && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/SKILL.md -o .claude/skills/docspeed-documents/SKILL.md && \
curl --fail --silent --show-error https://api.docspeed.ai/agent-tools/skills/docspeed-documents/scripts/upload.py -o .claude/skills/docspeed-documents/scripts/upload.py

O Claude registra ambos neste projeto. Mantenha o nome do servidor e a URL antes de --header, e mantenha as aspas simples para que a configuração salva contenha o nome da variável, nunca a chave. No mesmo terminal, inicie:

MCP_TOOL_TIMEOUT=1200000 claude

Se claude mcp get docspeed mostrar Aprovação pendente, inicie a sessão interativa acima, aceite o prompt de confiança do workspace para seu projeto e revise e aprove o servidor MCP do projeto docspeed quando solicitado. O registro sozinho não aprova a conexão.

Seu primeiro resultado fundamentado

Dentro da nova sessão do cliente, insira /mcp (não no shell do seu terminal). Siga os prompts normais de confiança e permissão de ferramentas do cliente: revise a conexão e permita a operação de documento solicitada quando você pretender enviar esse documento. Confirme que o Docspeed está conectado e que a skill docspeed-documents está disponível. Anexe uma fatura autorizada e pergunte:

“Extraia o número da fatura, fornecedor, moeda, imposto, total e cada item de linha. Mostre a página de suporte e a evidência de origem para cada valor. Marque valores ausentes no documento como faltantes.”

Verifique cada valor retornado contra o original e abra sua evidência de origem. O upload envia o documento ao Docspeed e os encargos normais de processamento se aplicam. Um servidor conectado prova a descoberta, não a precisão do documento.

Se o MCP ainda estiver conectando, a skill tenta a descoberta uma vez. Se as ferramentas permanecerem indisponíveis, ela oferece explicitamente leitura nativa/local para você escolher. Ask fornece caixas de origem que facilitam a verificação de respostas em digitalizações e documentos longos.

Leia a skill antes de instalar. Os comandos seguem a documentação MCP do Codex e a documentação MCP do Claude.

Envie um documento local em um comando

Com DOCSPEED_API_KEY definido no mesmo terminal, execute o helper instalado em um documento que você autoriza enviar ao Docspeed. Python 3.10+ é necessário para este helper opcional, sem pacotes extras:

# Codex project:
python3 .agents/skills/docspeed-documents/scripts/upload.py "/absolute/path/to/document.pdf"

# Claude Code project:
python3 .claude/skills/docspeed-documents/scripts/upload.py "/absolute/path/to/document.pdf"

O helper transmite bytes multipart diretamente para POST https://api.docspeed.ai/api/v1/upload usando o campo de formulário files existente. Ele mantém os bytes do documento fora da conversa do seu agente e imprime apenas:

{"file_id":"your-returned-file-id","filename":"document.pdf"}

Dê essa referência ao seu agente com sua pergunta sobre o documento. Use file_id no parâmetro real file_id ou file_ids de cada ferramenta; as amostras do Docster também usam filename. Reutilize-a entre chamadas. O upload e a conexão MCP devem pertencer à mesma conta.

O helper aceita um PDF/imagem suportado não vazio de até 50 MiB; a API o valida. Ele lê a chave apenas do ambiente, exige HTTPS verificado e não segue redirecionamentos ou novas tentativas automáticas. Se uma conexão falhar após o envio dos bytes, o resultado do upload pode ser desconhecido; não tente novamente às cegas. Nenhuma publicação de URL ou novo fluxo de credenciais é necessário. O upload em si não executa extração.

Use upload direto para qualquer coisa maior que 4 KiB. Para uma entrada pequena files_upload apenas, este comando portátil Python/stdin funciona em macOS e Linux e recusa arquivos maiores:

python3 -c 'import base64,sys; data=sys.stdin.buffer.read(4097); len(data)<=4096 or sys.exit("Use direct upload for files larger than 4 KiB"); print(base64.b64encode(data).decode("ascii"))' < "/absolute/path/to/tiny.pdf"

Passe esse resultado pequeno como content_base64 com o filename original. Nunca imprima o base64 de um documento maior na conversa.

Inspecione um resultado antes de integrar

Abra a fatura sintética original ao lado de sua extração registrada. Selecione um campo ou célula de item de linha para ver a região de origem exata retornada com aquele valor e baixe o PDF e o JSON do resultado.

Explore o exemplo de revisão de origem

Uma execução registrada do Codex: 11 campos de fatura e 15 valores de itens de linha foram verificados contra a origem. Este é um teste sintético histórico, não uma demonstração ao vivo, um resultado de cliente ou uma garantia geral de precisão. Nenhuma chave de API ou cobrança de processamento é necessária para inspecioná-lo.

Ou inspecione um Q&A registrado e acompanhamento com citações de origem. Este exemplo de fatura sintética mostra duas chamadas Ask salvas de uma verificação MCP interna, com as respostas retornadas e áreas de origem. Não é uma conversa de agente registrada nem uma demonstração de processamento ao vivo.

Compare dois acordos sintéticos com Q&A citado. Esta execução registrada de API direta mostra uma comparação de período de aviso e suas caixas de origem. A resposta inicial sobre taxas omite o pagador e a data de vencimento; ambas as limitações são visíveis ao lado das passagens originais.

1. Inspecione a evidência. Compare um valor retornado com o texto dentro de sua caixa de origem. O exemplo preserva o zero impresso e os tipos numéricos.
2. Conecte as ferramentas. Siga a configuração abaixo usando sua própria conta e o guia completo de capacidades do pacote.
3. Tente sua tarefa de documento. Use o comando de upload direto para um PDF/imagem autorizado e dê o ID de arquivo retornado ao seu agente. Entradas pequenas também podem usar files_upload. O MCP hospedado não pode ler um caminho local nem ingerir uma URL por conta própria. Encargos normais de processamento se aplicam.

Escolha a operação que sua aplicação precisa: OCR ou Parse para conteúdo de documento; Classify e Split para pacotes; Layout, Tables, Charts ou Equations para elementos de página; Schema Auto e Extract para campos; Ask para respostas citadas; Compare para valores correspondentes de documentos. Synthesize usa sua API separada e não é exposto no catálogo MCP atual; os limites de fidelidade permanecem em validação. Docster adiciona fluxos de trabalho reutilizáveis através da interface autenticada descrita abaixo. O download explica os caminhos suportados e as limitações.

MCP compare retorna um veredito compacto, itens e evidência de origem por padrão. Defina include_extractions: true para extrações completas por documento. Ambos os modos mantêm a geometria da página de origem e as regiões de fundamentação inalteradas; clientes HTTP API existentes mantêm a resposta completa por padrão.

Instalador ZIP alternativo

Baixe o ZIP de integração. Descompacte o download e abra um terminal dentro de docspeed-agent-tools. Use Python 3.10 ou posterior. No Python 3.10, instale sua dependência TOML com python3 -m pip install -r requirements.txt; Python 3.11+ usa sua biblioteca padrão.

Defina sua chave de API com o prompt oculto acima, execute o helper e inicie seu cliente no mesmo terminal. Mantenha a chave fora de chats e arquivos compartilhados.

1. Verifique a conexão

python3 scripts/setup.py check --catalog-out /tmp/docspeed-tools.json

A verificação autentica, inicializa o MCP e lista as ferramentas disponíveis. Ela não envia um documento nem executa extração.

2. Instale para seu cliente

python3 scripts/setup.py install --client codex --project /absolute/path/to/your/project

# For Claude Code:
python3 scripts/setup.py install --client claude --project /absolute/path/to/your/project

O instalador adiciona a conexão do projeto e a skill, preserva configurações não relacionadas e armazena apenas o nome da variável de credencial. Configurações existentes conflitantes do Docspeed exigem revisão manual.

3. Inicie uma nova sessão

Abra o projeto no seu agente, siga seus controles normais de confiança e permissão e inspecione /mcp. A conexão deve estar ativa antes que as ferramentas possam ser selecionadas. Instalar o pacote não injeta ferramentas em uma conversa existente.

Configuração MCP direta opcional para Codex

Para clientes Codex com Code Mode, adicione --codex-direct-mcp ao comando do instalador para expor o namespace DocSpeed diretamente. Esta configuração foi usada em uma chamada MCP nativa registrada com Codex CLI 0.159.2; não é um requisito universal nem uma garantia de seleção. O catálogo completo permanece disponível e seu modelo, confiança e configurações de aprovação permanecem inalterados. Revise as configurações personalizadas existentes do Code Mode antes de mesclar o trecho config/codex-direct-mcp.toml incluído.

Servidores de projeto do Claude Code também precisam da aprovação MCP normal do cliente. Uma conexão MCP saudável é separada do acesso a um modelo Claude.

Peça o resultado que você precisa

“Extraia o fornecedor, número da fatura, imposto, total e cada item de linha deste PDF. Inclua evidência para cada valor.”

“Nestes PDFs de políticas, quais exclusões se aplicam a danos por inundação? Cite as páginas relevantes.”

“Crie um fluxo de trabalho reutilizável de reconciliação de fatura, ordem de compra e recibo com uma tela de revisão e um endpoint de API.”

A skill complementar ajuda o agente a reconhecer essas tarefas mesmo quando você não nomeia o Docspeed. A seleção ainda depende da solicitação, das ferramentas disponíveis e das permissões. Escolhas explícitas de provedor e requisitos somente locais têm precedência.

Crie com Docster

As construções de fluxo de trabalho Docster estão disponíveis para contas Docspeed autenticadas usando uma chave de API Docspeed padrão. Encargos normais de uso e validação de fluxo de trabalho se aplicam.

Execute python3 scripts/setup.py check --require-docster para exigir a interface completa de construção, status, revisão e invocação. Se essas ferramentas estiverem ausentes, a implantação conectada não pode aceitar uma transferência Docster.

docster_build começa com esclarecimento, retém um attempt_id e então constrói o fluxo de trabalho solicitado. Verifique docster_status e sua evidência de validação; uma solução está pronta somente quando seu status é ready. Use docster_revise para atualizá-la e docster_invoke para executá-la em novos documentos enviados.

As ferramentas de documento são executadas de forma síncrona. APIs legadas de definição de agente e de trabalho não são expostas através deste catálogo MCP. Construir um fluxo de trabalho privado não o publica nem autoriza o envio de resultados a outras pessoas.

Conexão manual

Endpoint HTTP streamable: https://api.docspeed.ai/mcp/. A autenticação usa uma chave de API Docspeed como token bearer. Mantenha a barra final.

Configuração Codex

[mcp_servers.docspeed]
url = "https://api.docspeed.ai/mcp/"
bearer_token_env_var = "DOCSPEED_API_KEY"
startup_timeout_sec = 30
tool_timeout_sec = 1200

Adicione isso ao seu .codex/config.toml de projeto ou configuração de usuário. O download também contém configuração do Claude Code, manifestos de plugin portáteis, a skill complementar e um executor de avaliação de roteamento.

Entradas e evidências

A produção suporta PDF, PNG, JPEG/JPG, TIFF/TIF, WebP, BMP e GIF. TIFF de várias páginas é indexado por página. Fluxos de trabalho nativos de Word/Excel (DOCX/XLSX) estão disponíveis através de APIs beta separadas, entrando em contato com o Docspeed.

O upload envia os documentos selecionados ao Docspeed; use apenas arquivos autorizados para o fluxo de trabalho. Processamento e construções usam sua cota e cobrança normais de API. Resultados fundamentados preservam suas regiões de origem; valores ausentes e falhas de processamento devem permanecer explícitos. Uma verificação de conexão bem-sucedida comprova a descoberta, não a precisão dos documentos ou a conclusão do fluxo de trabalho. A avaliação de seleção incluída mede as decisões de roteamento separadamente da execução real das ferramentas e da qualidade dos documentos.

Guia completo incluído no download · Referência MCP do Codex · Referência MCP do Claude Code