Como adicionar servidores MCP ao Raycast no Mac

O LMCP executa ferramentas locais no seu dispositivo. Os provedores de IA na nuvem e os serviços conectados podem receber os dados solicitados; os termos deles se aplicam.

Por que adicionar servidores MCP ao Raycast?

Raycast é o lançador no qual usuários avançados de Mac vivem: uma tecla e você pesquisa, alterna ou calcula. O Raycast AI coloca um modelo de chat nessa mesma janela, mas, pronto para uso, o modelo só pode conversar. Ele não vê sua caixa de entrada, calendário ou arquivos.

MCP (Model Context Protocol) fecha essa lacuna. Um servidor MCP expõe ações reais — “pesquise meu e-mail”, “liste os eventos de hoje”, “encontre aquele PDF” — como ferramentas que a IA pode chamar. Adicione um ao Raycast e o Quick AI deixa de ser um chatbot para se tornar um assistente que opera seu Mac.

O problema é que a maioria dos servidores MCP cobre um único app, portanto uma configuração útil exige instalar e manter cinco ou seis deles. O LMCP segue o caminho oposto: um instalador assinado, um servidor, 240+ ferramentas em cerca de 24 domínios de apps — e a mesma instalação também atende Claude Desktop, Cursor e VS Code, portanto o Raycast não é uma configuração separada.

O que você vai precisar

• macOS 13 (Ventura) ou posterior — Apple Silicon ou Intel
• Raycast com Raycast Pro — servidores MCP personalizados são um recurso de AI (Pro)
• Node.js — o Raycast inicia o LMCP com npx via stdio
• LMCP — instala em cerca de 30 segundos (próxima etapa)

Você não precisa de chaves de API, tokens OAuth ou contas para nenhum dos apps conectados. O LMCP conversa com Mail.app, Calendar, Messages e o restante através das APIs nativas do macOS, portanto a IA recebe o que já está configurado no seu Mac.

Etapa 1: instalar o LMCP no Mac

Baixe o app (macOS 13+) e execute o instalador. De qualquer forma, o LMCP aparece na barra de menus e clientes de desktop como Claude Desktop e Cursor são configurados automaticamente.

curl -fsSL 'https://local-mcp.com/install?ref=guide-raycast-mac' | bash

No primeiro uso, o macOS pedirá permissão para o LMCP acessar cada app (Mail, Calendar e assim por diante). Clique em “Permitir” — esse consentimento por app é o modelo de segurança: nada fica acessível até você aprovar.

Etapa 2: adicionar o LMCP ao Raycast

1. Abra o Raycast e execute o comando Manage MCP Servers.
2. Pressione Cmd + N para adicionar um servidor e cole este JSON:

{
  "command": "npx",
  "args": ["-y", "local-mcp@latest"]
}

Envie o formulário. O Raycast inicia o servidor via stdio usando npx, por isso o Node.js deve estar instalado. A tag @latest significa que o Raycast sempre inicia a versão atual — não há nada para atualizar manualmente.

Etapa 3: experimentar

Abra o Raycast AI (Quick AI ou um AI Chat) e pergunte:

List my email accounts

O Raycast chama a ferramenta no seu Mac e devolve o resultado sem sair do lançador. A partir daí, experimente os prompts que as pessoas realmente usam:

• “Summarize my unread emails” — uma triagem da sua caixa de entrada na janela do lançador.
• “What is on my calendar today?” — lê o Calendar.app diretamente.
• “Find the PDF about the Q3 contract in my Downloads” — pesquisa seus arquivos reais.
• “Send a message to Ana saying I am running 10 minutes late” — redige um iMessage e mostra antes de enviar.
• “What did I miss in Teams this morning?” — atualiza você sobre canais e chats.

Antes de autorizar uma ferramenta que altera estado, revise os requisitos atuais de prévia e confirmação específicos da plataforma. Essas proteções variam entre ferramentas e clientes de IA.

O que o Raycast AI pode fazer com o LMCP

Um servidor, 240+ ferramentas. Os domínios mais usados no lançador:

• Mail — listar, ler, pesquisar, enviar, responder, mover mensagens, salvar anexos (qualquer conta no Mail.app: Gmail, iCloud, Outlook, Exchange, IMAP)
• Calendar — listar eventos entre calendários, criar, atualizar e excluir eventos
• Messages — ler e pesquisar conversas iMessage, enviar mensagens
• Files & Finder — pesquisar, listar, ler e gravar arquivos e pastas
• Notes & Reminders — criar e pesquisar notas, gerenciar listas de lembretes
• Contacts — procurar pessoas, telefones e endereços
• Microsoft 365 — correio e calendário Outlook, canais e chats Teams, arquivos OneDrive
• Documentos Office — ler e criar Excel, Word e PowerPoint; ler PDFs
• WhatsApp & Slack — ler, pesquisar e enviar onde estiverem conectados

Como todas as ferramentas são executadas na mesma sessão, o Raycast AI pode encadeá-las: ler um e-mail, verificar conflitos no calendário e redigir a resposta — um prompt, três apps, sem trocar de janela.

Quais contas e apps funcionam?

O LMCP não se conecta a serviços — ele se conecta aos apps no seu Mac e herda todas as contas que esses apps já têm:

• E-mail — toda conta configurada no Mail.app: Gmail, iCloud, Outlook.com, Exchange / Microsoft 365 ou qualquer provedor IMAP. Várias contas funcionam lado a lado, e você pode dizer qual usar (“envie do meu e-mail de trabalho”).
• Calendar — todo calendário visível no Calendar.app, inclusive os assinados e compartilhados.
• Messages — suas conversas iMessage, com sessão iniciada neste Mac.
• Microsoft 365 — Outlook, Teams e OneDrive se conectam com sua conta de trabalho existente.

Se você consegue ver no Mac, o Raycast AI pode alcançá-lo — não há uma lista separada de “provedores compatíveis” para verificar, porque os próprios apps são a integração.

Um servidor versus uma pilha de servidores de um app

Procurar servidores MCP para usar com Raycast revela muitos projetos sólidos de propósito único — um servidor Apple Mail, um Calendar, um de sistema de arquivos. Eles funcionam e são uma boa escolha se você gosta de montar sua própria pilha. A comparação honesta:

Em resumo: escolha servidores de propósito único se quiser uma configuração mínima e hackeável para um app. Escolha LMCP se quiser todo o Mac disponível ao Raycast AI em uma instalação de dois minutos — com o mesmo servidor já ligado a cada outro cliente MCP que você usa.

Ferramentas locais e limites de dados

• O LMCP executa como servidor local na sua máquina; o Raycast o inicia via stdio
• Ele lê seus apps por APIs nativas do macOS — sem scraping, sem sincronização em nuvem
• Os resultados passam do seu Mac para a conversa de IA que você já tem — um provedor de IA hospedado na nuvem recebe os resultados solicitados sob seus próprios termos de tratamento de dados
• Cada app exige uma concessão explícita de permissão macOS antes de qualquer ferramenta tocá-lo

Sem chaves de API e sem OAuth também significa nenhum token de terceiros que possa vazar. Seus e-mails, eventos e arquivos permanecem onde estão — nos seus apps, na sua máquina.

Como aproveitar ao máximo ferramentas MCP em um lançador

Um lançador recompensa prompts curtos, e eles às vezes deixam o modelo sem saber se deve responder de memória ou chamar uma ferramenta. Três hábitos fazem diferença:

• Nomeie seus dados. “Check my calendar” e “search my email” indicam que a resposta vive no Mac, não no conhecimento geral do modelo.
• Encadeie em um prompt. O objetivo de 240+ ferramentas em um servidor é que uma solicitação cruze apps: “find the invoice email, save the attachment to Desktop, and add a reminder to pay it Friday”. Três ferramentas, uma tecla.
• Deixe a prévia trabalhar para você. Tudo que envia, move ou exclui mostra exatamente o que acontecerá. Diga sim rápido se estiver correto — mas leia, pois essa prévia é a rede de segurança que torna seguro um fluxo na velocidade do lançador.

Solução de problemas

Não existe o comando “Manage MCP Servers”

Servidores MCP personalizados fazem parte do Raycast AI, que exige Raycast Pro. Atualize em Raycast Settings e busque o comando novamente. (O LMCP também funciona com clientes como Claude Desktop se quiser testá-lo sem Pro.)

O servidor não inicia

Duas causas comuns: o app LMCP não está em execução (verifique o ícone na barra de menus e inicie-o de Aplicativos se faltar) ou npx não está no PATH usado pelo Raycast. Instalar Node.js em nodejs.org o coloca em local padrão; depois de instalar, remova e adicione novamente a entrada do servidor.

Uma variante sutil: Node instalado por nvm vive no perfil do shell, que apps GUI como Raycast não leem — então npx funciona no terminal e ainda falha no Raycast. A correção confiável é uma instalação Node para todo o sistema (instalador oficial ou Homebrew).

A IA responde sem usar as ferramentas

Pergunte algo que claramente precise dos seus dados (“list my email accounts”, “what is on my calendar today?”). Se o modelo ainda responder de memória, verifique que a entrada LMCP aparece em execução em Manage MCP Servers e comece um novo chat de IA.

Erros de permissão negada de uma ferramenta

O macOS protege cada app com uma concessão explícita. Acesse System Settings > Privacy & Security > Automation e garanta que o LMCP tem acesso ao app necessário (Mail, Calendar, Messages…). A primeira chamada a cada app normalmente abre o pedido; se você o dispensou, corrija aqui.

Fluxos de trabalho reais

Prompts para colar diretamente no Quick AI:

Triagem da caixa de entrada sem abrir Mail

O lançador se torna sua triagem matinal: lida, priorizada e pré-redigida antes de abrir uma janela.

Preparação de reunião em uma tecla

E-mail, Notes e Reminders consultados de uma vez e condensados em um briefing — o tipo de cadeia entre apps que um servidor de propósito único não consegue fazer.

Encontre e envie

Busca de arquivo mais composição de e-mail em um prompt. O LMCP mostra a mensagem de saída para confirmação antes de enviar qualquer coisa.

Resumo do fim da semana

Uma semana de conversa dispersa condensada em uma nota — criada onde suas notas realmente vivem, não numa janela de chat que você perderá.

O que mais o LMCP pode fazer?

A mesma instalação atende todos os clientes MCP que você usa. Veja Apple Mail com Claude, Calendar sem OAuth, Microsoft Teams sem chaves API ou a lista completa de guias para tudo que as 240+ ferramentas alcançam.

Perguntas frequentes

Como adiciono um servidor MCP ao Raycast?

Execute o comando Manage MCP Servers no Raycast, pressione Cmd+N e cole { "command": "npx", "args": ["-y","local-mcp@latest"] }. Servidores MCP personalizados exigem Raycast Pro.

Preciso do Raycast Pro para usar servidores MCP?

Sim. Servidores MCP personalizados são um recurso de Raycast AI (Pro). O LMCP é local — e a mesma instalação funciona com clientes como Claude Desktop, Cursor e VS Code.

O que o Raycast AI pode fazer com LMCP?

O LMCP fornece ao Raycast AI 240+ ferramentas Mac locais: Mail, Calendar, Contacts, iMessages, Notes, Reminders, Files, Microsoft Teams, OneDrive, documentos Office e mais — todas no seu Mac, encadeáveis num prompt.

Preciso de chaves API ou senhas de app?

Não. O LMCP alcança seus apps pelas APIs nativas do macOS, então tudo configurado no Mac — cada conta Mail, calendário e chat — fica disponível sem chaves, OAuth ou senhas. O macOS pede uma concessão de permissão explícita por app.

Meus dados vão para a nuvem?

O LMCP executa ferramentas locais e devolve resultados solicitados ao cliente IA. O modelo por trás do Raycast processa os resultados. Se for hospedado na nuvem, seu provedor recebe esse conteúdo sob seus próprios termos de tratamento de dados.

Receitas prontas

Fluxos de copiar e colar que usam essas ferramentas:

• Faça sua IA preparar você para a próxima reunião
• Encontre cada pedido de cliente sem resposta em WhatsApp, Slack, Teams e e-mail
• Detecte e resolva conflitos de calendário antes que prejudiquem você

Guias relacionados

• Dê à IA acesso ao e-mail no Mac
• Conecte IA ao calendário do Mac — sem OAuth
• Dê ao Cursor acesso a e-mail, calendário e contatos
• A IA pode ler seus e-mails sem enviá-los à nuvem?
• Configuração Warp MCP no Mac
• Configuração Zed MCP no Mac
• Configuração VS Code MCP no Mac