Calypso RAG

Servidor MCP Calypso

RAG multimodal hospedado para Claude Desktop, Cursor e fluxos de trabalho de agentes — em um único comando npx.

Faça perguntas sobre PDFs, capturas de tela, gráficos e diagramas, e envie novo material de origem, sem executar um armazenamento vetorial, uma pilha Docker ou um pipeline de OCR. As respostas vêm com citações que você pode verificar.

Este servidor é uma superfície de Calypso Context — a mesma camada de conhecimento que sustenta o Calypso no WhatsApp, exposta a clientes MCP. Como as peças se encaixam →

• Configuração em um comando: npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-your-key-here
• RAG multimodal verdadeiro: lida com texto e elementos visuais nativamente por meio do Gemini File Search
• Envio e consulta: ferramentas dedicadas para arquivos de conhecimento duráveis e envios em lote
• Conversas de múltiplas etapas: respostas com contexto e redefinição via /new
• Fluxos de trabalho descobríveis: recursos e prompts para fluxos seguros de RAG, envio e ingestão

GitHub | Docs | Smithery | Registro Oficial de MCP

Tags: multimodal-rag, gemini-rag, hosted-rag-mcp, mcp-server

Em vez de conectar cada agente ou fluxo de trabalho a uma pilha de busca documental pontual, use este MCP como o ponto de entrada voltado a agentes para uma única camada de respostas reutilizável: envie o material de origem uma vez, recupere conteúdo de texto e visual e retorne respostas com evidências que os usuários possam verificar.

Início Rápido

# One-liner with npx
npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-your-key-here"

Ou com variáveis de ambiente:

CALYPSO_API_KEY="sk-..." npx -y @calypsohq/multimodal-rag-mcp-server

Em seguida, adicione o mesmo comando ao Claude Desktop, Cursor ou Smithery usando os exemplos de configuração abaixo.

Por que Escolher o Calypso

Sem armazenamento vetorial local, sem Docker Compose e sem pipeline separado de OCR ou visão antes que um agente possa fazer uma pergunta fundamentada. Aponte o servidor para uma chave de API do Calypso e ele descobrirá os agentes e buckets de conhecimento da sua equipe na conexão.

• Zero infraestrutura: um único comando npx; nada para hospedar ou operar.
• Multimodal sem um segundo pipeline: texto e elementos visuais são indexados juntos, então um gráfico ou uma captura de tela pode ser consultado da mesma forma que um parágrafo.
• Respostas com evidências: as respostas incluem referências de origem e metadados de recuperação.
• Leitura e escrita: consulte o conhecimento e adicione a ele — arquivos, lotes e sites — a partir do mesmo servidor.

O que você obtém

• Agente Calypso multimodal de produção com memória de múltiplas etapas
• Ferramentas de envio integradas para arquivos individuais e envios de conhecimento em lote
• Descoberta automática das variantes de RAG e buckets de conhecimento da sua equipe
• Citações verificáveis com referências de origem e metadados de recuperação
• Recursos somente leitura e prompts reutilizáveis para fluxos de trabalho seguros

Por que RAG com Prioridade Multimodal

A maior parte do conhecimento empresarial não é apenas texto. A resposta geralmente está em uma captura de tela de configuração, uma tabela em PDF, um diagrama de produto, uma página de central de ajuda ou um gráfico dentro de um relatório. O Calypso empacota toda essa superfície de conhecimento em uma única camada de recuperação, para que os agentes possam fazer perguntas fundamentadas sem depender da memória genérica do modelo.

• Busque nos formatos que os usuários realmente usam: documentação, PDFs, capturas de tela, gráficos, diagramas, imagens de produto, artigos de suporte, manuais, políticas, FAQs e relatórios.
• Fundamente as respostas antes de o modelo escrever: o Gemini File Search recupera primeiro o contexto textual e visual relevante; depois, o agente Calypso responde com base nesse material de origem.
• Mostre a trilha de evidências: as respostas podem incluir referências de origem, fundamentação com ciência de página e metadados de recuperação, para que as pessoas verifiquem antes de confiar.
• Escopar a recuperação com metadados: use workspace, equipe, cliente, idioma, tipo de arquivo, status ou outros metadados para manter as respostas relevantes sem duplicar bases de conhecimento.
• Reutilize a mesma camada de conhecimento em todos os lugares: conecte Cursor, Claude Desktop, agentes de IA, fluxos do n8n, interface do produto, fluxos de suporte e experiências de site à mesma camada com base em fontes.

Na prática, isso significa que seu agente pode responder perguntas como:

• "Explique esta captura de tela de configuração e o PDF de política anexado. O que o representante de suporte deve fazer em seguida?"
• "O que este PDF de integração diz sobre regras de aprovação?"
• "Por que esta tela de configuração está falhando?"
• "Compare o gráfico de preços com a documentação do nosso plano e recomende o nível certo."
• "Resuma a política que se aplica a este ticket de suporte."
• "Qual plano de produto se encaixa neste cliente com base nos nossos documentos de preços?"
• "Compare o fluxo de ingestão diagramado com o fluxo de recuperação."

O que este MCP faz

Com calypso-agent, você pode:

• Fazer perguntas fundamentadas contra a base de conhecimento do Calypso configurada
• Selecionar qualquer variante de RAG da equipe descoberta com o argumento opcional model
• Continuar uma conversa de múltiplas etapas por meio do modelo de conversa nativo /v1/responses
• Redefinir o contexto da conversa com /new
• Usar o mesmo endpoint de Respostas compatível com OpenAI que atende calypso-agent
• Descobrir recursos e prompts integrados para os fluxos de trabalho do Calypso suportados

Requisitos

• Node.js 18+
• O servidor usa primitivas da Web Fetch API (fetch, Headers, Request, Response, FormData, Blob e File) para chamadas de API e compatibilidade com SDK. O pacote inicializa globais ausentes na inicialização para runtimes MCP que expõem apenas parte da superfície da Web API do Node 18+.
• Um endpoint de API do Calypso que exponha:
  • POST /v1/responses
  • GET /v1/rag-agent/models
  • GET /v1/knowledge/buckets
  • POST /v1/knowledge/files/upload-session
  • POST /v1/knowledge/files/upload-session/{session_id}/finalize
  • POST /v1/knowledge/files:batch/upload-session
  • POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize
  • GET /v1/knowledge/batches/{batch_id}
• Uma chave de API do Calypso (sk-...)

Configuração

Variáveis de ambiente:

• CALYPSO_API_KEY (obrigatório)
• CALYPSO_API_BASE_URL (opcional, padrão https://api.calypso.so/v1)

Flags de CLI:

• --api-key
• --api-base-url

Precedência de configuração:

1. Flags de CLI / argumentos de comando fornecidos pelo Smithery
2. Variáveis de ambiente
3. URL base padrão (https://api.calypso.so/v1)

Executar com npx

npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-..."

Executar com variáveis de ambiente

env CALYPSO_API_KEY="sk-..." CALYPSO_API_BASE_URL="https://api.calypso.so/v1" npx -y @calypsohq/multimodal-rag-mcp-server

Configurar no Cursor

Adicione um novo servidor MCP (tipo de comando) como:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Configurar no Claude Desktop

1. Abra a configuração de MCP do Claude Desktop

No Claude Desktop:

Claude -> Settings -> Developer -> Edit Config

No macOS, o arquivo geralmente é:

~/Library/Application Support/Claude/claude_desktop_config.json

O Claude Desktop usa claude_desktop_config.json para servidores MCP de desktop. O Claude Code usa locais de configuração separados, como ~/.claude.json ou .mcp.json em nível de projeto.

2. Adicione o servidor MCP Calypso

Cole isto em claude_desktop_config.json:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    }
  }
}

Substitua:

• sk-your-calypso-api-key

pela sua chave de API real do Calypso.

3. Reinicie o Claude Desktop completamente

Encerre totalmente o Claude Desktop e reabra-o.

Não feche apenas a janela. No macOS:

Cmd + Q

Após a reinicialização, o MCP deve aparecer no Claude com estas ferramentas disponíveis:

• calypso-agent
• calypso-list-buckets
• calypso-upload-file
• calypso-upload-files-batch

Opcional: Salvar Artefatos do Claude no Seu Mac

O Calypso fornece ferramentas de RAG multimodal hospedadas. Ele não grava relatórios gerados, resumos, CSVs, arquivos JSON ou artefatos de busca na web diretamente no seu computador local.

Para permitir que o Claude Desktop salve arquivos gerados localmente, adicione o servidor MCP de sistema de arquivos padrão junto com o Calypso e restrinja-o a uma pasta segura dedicada.

Crie a pasta primeiro:

mkdir -p ~/Claude

Em seguida, adicione ambos os servidores a claude_desktop_config.json:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Claude"
      ]
    }
  }
}

Encerre totalmente e reabra o Claude Desktop após alterar a configuração.

Exemplo de prompt:

Use Calypso for the grounded RAG answer, then save the final report as /Users/yourname/Claude/report.md using the filesystem tool.

Por segurança, conceda acesso ao sistema de arquivos apenas a uma pasta dedicada, como ~/Claude, e não ao seu diretório pessoal inteiro.

Preocupação	Melhor Responsável
Respostas RAG com base em fontes	MCP Calypso
Envio de arquivos para o Calypso	MCP Calypso
Gravação de .md, .pdf, .json, .csv, etc. no seu Mac	MCP de sistema de arquivos
Artefatos de busca na web do Claude	Claude mais prompt de MCP de sistema de arquivos

Smithery

O servidor está disponível no Smithery e é iniciado pelo mesmo caminho de pacote npx usado pelos clientes de desktop.

Configuração de usuário do Smithery:

• calypsoApiKey (obrigatório)
• calypsoApiBaseUrl (opcional, padrão https://api.calypso.so/v1)

O caminho de inicialização do Smithery é equivalente a:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Use calypsoApiBaseUrl somente ao segmentar uma implantação auto-hospedada compatível com Calypso. O padrão de nuvem não precisa de substituição.

Solução de Problemas

• Chave de API ausente: forneça --api-key ou CALYPSO_API_KEY
• Host de API errado: certifique-se de que --api-base-url / CALYPSO_API_BASE_URL termine em /v1
• Implantação auto-hospedada: substitua a URL base somente se você não estiver usando https://api.calypso.so/v1
• Incompatibilidade de inicialização do Smithery: use o caminho empacotado npx -y @calypsohq/multimodal-rag-mcp-server em vez de executar node dist/index.js a partir de um clone novo
• FormData is not defined ou Headers is not defined: atualize para o pacote mais recente. O servidor MCP inicializa globais ausentes da Web Fetch API antes da execução das ferramentas de envio.
• ENOENT para /mnt/user-data/uploads/...: esse caminho pertence a um agente hospedado ou sandbox de anexos, não necessariamente ao servidor MCP. Tente novamente com contentBase64 em vez de filePath.
• Salvamento de artefatos locais: as respostas do Calypso podem ser usadas com o servidor MCP de sistema de arquivos do Claude Desktop, mas o Claude deve ser explicitamente solicitado a salvar a saída final em um caminho local permitido.

Escolhendo filePath vs contentBase64

Use filePath para instalações MCP locais, incluindo configurações do Claude Desktop e do Cursor que iniciam este pacote com um comando local, como:

npx -y @calypsohq/multimodal-rag-mcp-server

Nessa configuração, o processo do servidor MCP é executado na sua máquina e pode ler caminhos disponíveis para a mesma conta de usuário. Passe o caminho local diretamente; o servidor lê os bytes brutos e os envia pela URL da sessão de envio do Calypso. Você não precisa codificar arquivos locais em base64.

Use contentBase64 para clientes MCP hospedados ou remotos, incluindo servidores hospedados no Smithery, runtimes de navegador/nuvem, conteúdo gerado em memória e contêineres de agentes. Nesses ambientes, um caminho no seu Mac ou estação de trabalho não pode ser lido pelo processo do servidor MCP.

Se um caminho começar com /mnt/user-data/uploads, /mnt/data, /mnt/attachments ou outro prefixo de sandbox hospedado, não o envie como filePath a menos que este servidor MCP esteja sendo executado nesse mesmo sandbox. Use contentBase64 ou outra fonte de bytes inline.

Ferramentas disponíveis

calypso-agent

Acesso direto ao agente Calypso.

Observações:

• Não roteia automaticamente para outras personas ou agentes.
• Descobre automaticamente as variantes calypso-agent disponíveis da chave de API na inicialização.
• Use o argumento opcional model para escolher uma variante nomeada, como calypso-agent:pricing.
• Cada variante de modelo mantém sua própria cadeia de conversa MCP, então alternar variantes não continua o thread errado.
• Usa POST /v1/responses em vez de POST /v1/chat/completions.
• As primeiras etapas criam uma conversa nomeada, e as etapas de acompanhamento encadeiam com previous_response_id.
• fileIds opcionais são suportados para perguntas com escopo de recuperação. Novos envios devem usar as ferramentas de envio de conhecimento durável e aguardar a indexação antes de perguntar.
• Use /new como prompt para redefinir a conversa MCP.

calypso-search

Pesquisa seu conhecimento diretamente e retorna passagens correspondentes, sem pedir que um agente componha uma resposta.

Use quando quiser evidências em vez de prosa — verificar se algo está indexado, reunir fontes antes de uma decisão ou permitir que um agente chamador faça seu próprio raciocínio sobre as passagens.

Observações:

• Usa POST /v1/search.
• query é obrigatório.
• agent limita a pesquisa ao conhecimento de uma variante de agente; buckets restringe a buckets específicos.
• maxResults é limitado a 1–20.

Exemplo:

{
  "query": "annual plan refund window",
  "buckets": ["support-handbook"],
  "maxResults": 5
}

calypso-list-buckets

Lista os buckets da equipe vinculada à chave de API do Calypso configurada.

Observações:

• Usa GET /v1/knowledge/buckets.
• Não aceita team_id; o Calypso deriva o escopo da equipe a partir da chave de API.
• Retorna ids de buckets, slugs, nomes, status, contagens de membros, contagens de fontes e prontidão do armazenamento de buckets.
• Padrão: apenas buckets ativos. Passe includeArchived: true quando precisar de buckets arquivados para auditorias ou limpeza.
• Use antes de calypso-upload-file ou calypso-upload-files-batch quando precisar escolher um bucket de destino.
• calypso://rag-agent-models responde quais buckets estão vinculados a cada variante RAG. calypso-list-buckets responde quais buckets existem para a equipe da chave de API.

Exemplo:

{
  "includeArchived": false
}

calypso-get-file

Busca os metadados e o status de indexação de um arquivo de conhecimento pelo id do arquivo.

Observações:

• Usa GET /v1/knowledge/files/{file_id}.
• Resolve o fileIds opaco de calypso-list-buckets em nome do arquivo, tipo MIME, tamanho, status de indexação e estado de sincronização por bucket.
• Passe verify: true para verificar novamente junto ao provedor (?verify=gemini) — mais lento, porém autoritativo quando um status parece desatualizado.

Exemplo:

{
  "fileId": "file_123",
  "verify": true
}

calypso-add-website

Ingere um site em um bucket de conhecimento, para que o conteúdo das páginas se torne consultável junto com arquivos enviados.

Observações:

• Usa POST /v1/knowledge/websites.
• url é obrigatório, assim como um destino — um de bucketIds, bucketSlugs ou bucket.
• title, tagsHint e preferredLanguage opcionais ajudam a classificar a fonte.
• Passe idempotencyKey para tornar uma nova tentativa segura; ele é enviado como o cabeçalho Idempotency-Key.
• Assim como nos uploads de arquivos, a aceitação não é o mesmo que estar consultável — a página ainda precisa terminar a indexação.

Exemplo:

{
  "url": "https://example.com/pricing",
  "bucket": "pricing",
  "title": "Public pricing page",
  "idempotencyKey": "pricing-page-2026-08"
}

calypso-create-bucket

Cria um bucket vazio para o fluxo de criar e depois preencher.

Observações:

• Usa POST /v1/knowledge/buckets (requer um backend com esse endpoint implantado e a capacidade knowledge:bucket:create na chave de API).
• O servidor normaliza o slug; colisões retornam um erro bucket_slug_exists tipado.
• Replays de idempotencyKey retornam o bucket existente em vez de gerar erro.
• Uploads ainda podem criar buckets implicitamente via bucketSlugs + createMissingBuckets; esta ferramenta existe para criar o destino primeiro.

Exemplo:

{
  "name": "Product docs",
  "slug": "product-docs",
  "idempotencyKey": "create-product-docs-1"
}

calypso-create-agent

Cria uma variante de agente Calypso vinculada a um ou mais buckets.

Observações:

• Usa POST /v1/rag-agent/agents (requer um backend com esse endpoint implantado e a capacidade rag:agent:create na chave de API).
• O payload de sucesso começa com model — passe-o diretamente para calypso-agent.
• Os vínculos de bucket são validados no servidor: buckets desconhecidos ou arquivados retornam bucket_not_found; colisões de id de agente retornam agent_id_exists; o limite de agentes do plano retorna agent_limit_reached.
• Criar um agente atualiza o catálogo de modelos e emite notificações MCP tools/list_changed + resources/list_changed, para que a nova variante seja utilizável sem reconectar.

Exemplo:

{
  "agentId": "support",
  "name": "Support agent",
  "bucketSlugs": ["product-docs"],
  "idempotencyKey": "create-support-agent-1"
}

calypso-upload-file

Envia um arquivo para o armazenamento de conhecimento durável baseado em buckets e para o pipeline de indexação.

Observações:

• Usa POST /v1/knowledge/files/upload-session, envia bytes diretamente para o armazenamento e finaliza com POST /v1/knowledge/files/upload-session/{session_id}/finalize.
• Uploads usam requisições de sessão JSON mais PUTs binários assinados, não uploads de formulário multipart.
• Retorna metadados de arquivo e tarefa, não um file_id de anexo de chat.
• Requer um bucket de destino via bucketIds, bucketSlugs ou bucket.
• Use filePath para instalações MCP locais do Claude Desktop/Cursor onde o servidor pode ler o caminho. Use contentBase64 para clientes MCP hospedados ou remotos que não conseguem ler caminhos locais.
• Se um agente vir um caminho como /mnt/user-data/uploads/file.pdf, ele não deve enviá-lo como filePath; deve enviar os bytes do arquivo como contentBase64.
• Suporta title, tags, metadata e idempotencyKey opcionais.
• Roteie uploads para buckets existentes com bucketIds ou bucketSlugs, ou use bucket como atalho de slug único.
• Passe createMissingBuckets: true com slugs de bucket quando quiser que o Calypso crie destinos ausentes durante o upload.
• Pode opcionalmente aguardar até que a indexação atinja um estado pronto antes de retornar.

Exemplo:

{
  "filename": "handbook.pdf",
  "mimeType": "application/pdf",
  "filePath": "/Users/me/Documents/handbook.pdf",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "waitForIndexing": true
}

calypso-upload-files-batch

Envia de 1 a 100 arquivos para o armazenamento de conhecimento durável em uma única requisição.

Observações:

• Usa POST /v1/knowledge/files:batch/upload-session, envia cada item aceito diretamente para o armazenamento e finaliza com POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize.
• Uploads usam requisições de sessão JSON mais PUTs binários assinados, não uploads de formulário multipart.
• Requer batchIdempotencyKey; o Calypso o usa para derivar o id durável do lote para novas tentativas.
• Requer um bucket de destino compartilhado via bucketIds, bucketSlugs ou bucket, a menos que cada item forneça seu próprio bucket de destino.
• Suporta padrões compartilhados de bucketIds, bucketSlugs, bucket e createMissingBuckets, além de substituições por item.
• Use filePath por item para instalações MCP locais do Claude Desktop/Cursor onde o servidor pode ler cada caminho. Use contentBase64 por item para clientes MCP hospedados ou remotos que não conseguem ler caminhos locais.
• Gera valores client_file_id seguros para Firestore quando clientFileId é omitido.
• accepted ou queued significa que o upload é durável, não necessariamente pronto para consulta. Use waitForBatchReady: true para consultar GET /v1/knowledge/batches/{batch_id}?include_items=true.
• Inspecione o status por item, bucketSyncStatus e bucketSync para distinguir conteúdo indexado de recuperação pronta para bucket.

Exemplo:

{
  "batchIdempotencyKey": "kb-seed-2026-06-04",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "items": [
    {
      "filename": "faq.txt",
      "mimeType": "text/plain",
      "filePath": "/Users/me/Documents/faq.txt"
    }
  ],
  "waitForBatchReady": true
}

Recursos disponíveis

calypso://server-info

Metadados do servidor somente leitura, incluindo versão do pacote, URL base da API, transporte, modelo de autenticação e capacidades expostas.

calypso://rag-agent-models

Catálogo de runtime somente leitura das variantes de modelo calypso-agent com escopo de equipe descobertas a partir da chave de API configurada, incluindo o buckets, bucket_ids e missing_bucket_ids ativos de cada variante. Se a descoberta não estiver disponível, este recurso recai sobre o calypso-agent base.

calypso://buckets

Lista de runtime somente leitura dos buckets de conhecimento da equipe vinculada à chave de API configurada. Use-a para inspecionar ids/slugs de buckets e a prontidão do armazenamento antes de uploads.

calypso://workflows

Um guia compacto dos fluxos de trabalho suportados de RAG e upload de arquivos.

calypso://security

Notas de segurança operacional para chaves de API, leituras de arquivos locais, uploads e registro de logs.

Prompts disponíveis

• calypso-question: redija uma pergunta de base de conhecimento fundamentada para calypso-agent
• calypso-ingestion: prepare um upload de armazenamento de conhecimento durável e uma consulta de acompanhamento
• calypso-reset-conversation: inicie um thread RAG limpo com /new

Fluxos de trabalho comuns (copiar/colar)

Recuperação de conhecimento

• Resumir um tópico:
  • Summarize the knowledge base guidance for campaign approvals
• Perguntar por uma resposta específica:
  • What does our documentation say about indexing retries?
• Comparar dois conceitos:
  • Compare file indexing with retrieval execution in the current architecture
• Iniciar um thread novo:
  • /new

Acompanhamento em múltiplas etapas

• Refinar uma resposta anterior:
  • Focus only on the ingestion path and ignore retrieval
• Pedir fontes ou justificativa:
  • Explain which documented components are involved and why

Fluxo de arquivos do armazenamento de conhecimento

• Descobrir buckets:
  • Chame calypso-list-buckets ou leia calypso://buckets antes de escolher um destino
• Enviar conhecimento durável:
  • Chame calypso-upload-file com o payload do arquivo e title, tags ou metadata opcionais
  • Prefira filePath para instalações MCP locais do Claude Desktop/Cursor; use contentBase64 para clientes MCP hospedados ou remotos que não conseguem ler caminhos locais
• Roteie conhecimento para buckets:
  • Use bucket: "support-handbook" para um destino, bucketSlugs para múltiplos destinos baseados em slug ou bucketIds quando você já tiver ids de bucket estáveis
• Criar destinos de bucket sob demanda:
  • Adicione createMissingBuckets: true ao usar atribuição de bucket baseada em slug e o destino pode ainda não existir
• Aguardar a indexação:
  • Passe waitForIndexing: true se quiser que a ferramenta bloqueie até que o arquivo de conhecimento seja indexado

Fluxo de lote do armazenamento de conhecimento

• Enviar muitos arquivos duráveis:
  • Chame calypso-upload-files-batch com items, batchIdempotencyKey e filePath por item para instalações MCP locais; use contentBase64 por item para clientes MCP hospedados ou remotos
• Roteie o lote para buckets:
  • Coloque bucket, bucketSlugs, bucketIds ou createMissingBuckets compartilhados na chamada da ferramenta e substitua por item apenas quando necessário
• Aguardar a prontidão para consulta:
  • Use waitForBatchReady: true e inspecione o status do item retornado mais os campos de sincronização de bucket antes de consultar conteúdo novo

Dicas

• Recomeçar: use /new para redefinir a conversa MCP (novo conversation_id + cadeia de respostas limpa).

Histórico de versões

Versão	Notas
3.0.0	Quebra. Removeu o suporte legado a id de modelo calypso-rag-agent — um id não reconhecido agora é um erro em vez de ser reescrito para a família canônica. Documentou calypso-search e calypso-add-website, e corrigiu calypso://server-info, que estava omitindo calypso-add-website.
2.4.0	Renomeou a ferramenta de pergunta calypso-rag-agent → calypso-agent. O catálogo de modelos agora usa o padrão da descoberta em vez de uma constante fixa.
2.3.x	Lançamento de busca e correções de acompanhamento.

Veja CHANGELOG.md para detalhes.

Atualizando para 3.0.0

Dois renames foram feitos entre 2.4.0 e 3.0.0, e nenhum tem alias.

• A ferramenta de pergunta é calypso-agent (era calypso-rag-agent). Clientes MCP detectam isso no próximo tools/list, mas qualquer prompt salvo, instrução de agente ou documentação que nomeie a ferramenta como string precisa ser atualizado.
• Ids de modelo devem ser canônicos. calypso-rag-agent e calypso-rag-agent:{id} não são mais reescritos para calypso-agent[:{id}]. Passar um deles agora falha com Unknown Calypso agent model, que nomeia calypso://rag-agent-models como o lugar para encontrar ids válidos. Leia esse recurso ou omita model para usar o padrão descoberto.

O URI do recurso calypso://rag-agent-models é deliberadamente inalterado. É um endereço publicado, não um shim de compatibilidade.