Use o Casii MCP no Cherry Studio

Pré-requisitos

1. Cherry Studio instalado e com sessão iniciada.
2. Uma chave de API criada no painel — a URL de MCP já vem preenchida na referência rápida abaixo.

Abrir API Keys

Referência rápida de conexão

A referência rápida já contém sua URL de MCP; basta trocar YOUR_API_KEY pela sua chave e informar no Cherry Studio.

{
  "mcpServers": {
    "casii": {
      "type": "streamableHttp",
      "url": "https://api.casii.io/mcp/",
      "name": "Casii MCP",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

As chaves nas capturas de tela estão ocultas — use a sua própria chave de API na configuração.

Passos de configuração

1. 1

   Abra o Cherry Studio e clique no ícone de engrenagem no canto inferior esquerdo para abrir as Configurações.

   
2. 2

   Na barra lateral das Configurações, clique em "MCP" em Ferramentas e depois em "+ Adicionar" no canto superior direito.

   
3. 3

   Escolha "Criação rápida" no menu.

   
4. 4

   Cole em "URL" o endereço MCP da referência rápida abaixo (mantenha a barra final). Em "Cabeçalhos", digite Authorization=Bearer SUA_CHAVE_API (um espaço entre Bearer e a chave) e clique em "Salvar" no canto inferior direito.

   
5. 5

   Role para cima e confira se o Nome é Casii e o Tipo é "HTTP transmissível (streamableHttp)". Ative o interruptor no canto superior direito — quando aparecer "Conectado" ao lado do nome e a aba Ferramentas mostrar a quantidade, a conexão está funcionando.

   
6. 6

   Volte ao chat e confirme que o Casii aparece como "Conectado" na lista de MCP acima da caixa de mensagem.

   
7. 7

   Escreva o pedido de exportação com suas palavras (pode copiar o exemplo abaixo). Na primeira vez que a IA chamar uma ferramenta do Casii, aparecerá uma confirmação — clique em "Permitir".

   
8. 8

   Aguarde a IA terminar. A resposta traz o número de registros, os créditos cobrados e um link de download CSV — clique para baixar. Para Excel, troque format=csv no fim do link por format=xlsx.

   

Verificar o funcionamento

Peça a exportação direto no chat do Cherry Studio, por exemplo:

A primeira chamada pede permissão de ferramentas; depois disso a IA faz detecção, orçamento e criação automaticamente. A criação e a continuação devem carregar uma chave de idempotência estável (idempotency_key, formato UUID) gerada uma única vez: repetir com a mesma chave e os mesmos parâmetros retorna as tarefas originais e nunca cobra duas vezes; apenas parâmetros alterados caracterizam uma nova operação com uma nova chave.