Assistentes de IA

O app de desktop para Mac e Windows pode funcionar como servidor MCP. Aí um assistente como o Claude Code ou o Copilot no VS Code consegue mostrar seus compartilhamentos, compartilhar arquivos por você, ler um arquivo de um compartilhamento sem baixar tudo, ou mandar algo para um dispositivo por perto. O assistente fala com o app no seu computador; por nós não passa nada.

Como ativar

No app de desktop, abra Configurações, procure "Servidor MCP" e ative. O app mostra o endereço e um token; copie os dois.

http://127.0.0.1:3473/mcp

O token é exigido em toda requisição. "Regenerar" emite um novo, e o antigo para de funcionar na hora; você vai precisar trocar em todos os clientes configurados.

O servidor escuta em todas as interfaces de rede do computador, não só na local, então com o token certo dá para conectar também de outras máquinas na sua rede local. Não passe o token para ninguém e desligue o servidor quando não estiver usando.

Claude Code

claude mcp add --transport http share-ninja http://127.0.0.1:3473/mcp \
  --header "Authorization: Bearer <token>"

VS Code

No .vscode/mcp.json do workspace ou no seu mcp.json de usuário:

{
  "servers": {
    "share-ninja": {
      "type": "http",
      "url": "http://127.0.0.1:3473/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Qualquer outro cliente que fale MCP por HTTP é configurado do mesmo jeito: o endereço, e o token como bearer no cabeçalho Authorization.

O que o assistente pode fazer

Consultar: get_status, list_my_shares, list_shared_with_me, list_transfers, list_nearby, list_workspaces, get_settings.
Ler de um compartilhamento sem baixá-lo: browse_share mostra um nível de pasta, read_share_range devolve um arquivo ou um trecho dele, como texto ou como imagem.
Compartilhar e baixar: create_share cria um link a partir de arquivos locais, delete_share encerra um compartilhamento, start_download baixa um link para a pasta de downloads ou retoma um download já começado, pause_transfer, resume_transfer, delete_download.
Dispositivos por perto: send_nearby_share, accept_nearby_offer, reject_nearby_offer.
Diagnosticar o app: get_diagnostics, recent_events, tail_logs, set_log_level. Nada disso devolve chaves ou tokens.

Dá para pedir com suas palavras: compartilhe os PDFs desta pasta e me dê o link; o que tem no compartilhamento que a Anna me mandou; leia o README daquele compartilhamento; encerre todos os compartilhamentos com mais de uma semana; mande este build para o meu notebook.

O assistente vê o que o app vê e pode fazer o que o app faz, inclusive encerrar compartilhamentos e excluir downloads. Um compartilhamento cuja chave você não tem ele não consegue ler, e nós também não.