Enviar arquivos entre o celular e o seu agente de IA
Última verificação
Os agentes de programação rodam no seu computador, mas a captura de tela do bug, a foto do quadro branco ou o PDF de um cliente muitas vezes está no celular. O tosstome mcp dá ao agente uma caixa de entrada para a qual o celular pode enviar, e uma forma de devolver arquivos ao celular, por meio do Model Context Protocol.
O que o agente pode fazer
| Ferramenta | O que faz |
|---|---|
get_inbox_link | Inicia a caixa de entrada do computador e devolve o link e um QR code para o seu celular |
wait_for_files | Espera até você enviar arquivos ou uma mensagem de texto e então devolve os caminhos. As mensagens e as imagens pequenas voltam inline, então o agente lê o texto ou vê a captura de tela na hora |
list_received_files | Lista o que chegou desde que o agente foi iniciado |
send_files | Envia arquivos locais, uma mensagem de texto ou os dois para o seu celular usando um código de 6 dígitos, ou para o link da caixa de entrada de outro computador |
Configuração
Instale a ferramenta de linha de comando do tosstome (Node.js 22 ou mais recente) e depois registre-a no seu agente. No Claude Code:
claude mcp add tosstome -- tosstome mcp
Para outros clientes MCP, adicione um servidor stdio com este comando:
{
"mcpServers": {
"tosstome": { "command": "tosstome", "args": ["mcp"] }
}
}
Os arquivos recebidos são salvos em ./tosstome-inbox, relativo ao lugar em que o agente inicia o servidor, em geral a pasta do seu projeto, para que o agente os leia com suas ferramentas de arquivo normais. Adicione essa pasta ao .gitignore ou use --dir para colocar os arquivos em outro lugar.
Do celular para o agente
- Peça o link da caixa de entrada ao agente. Ele chama
get_inbox_linke mostra o link e o QR code. - Abra o link no celular e adicione-o à tela inicial. O link continua o mesmo, então este passo é feito uma única vez.
- Diga ao agente que você vai enviar algo. Ele chama
wait_for_files. - Escolha os arquivos, ou digite uma mensagem, como um erro que você copiou ou um link, e toque em Enviar. O agente recebe os caminhos, lê as mensagens e vê as imagens diretamente.
Do agente para o celular
- Abra o toss2.me no celular e toque em Criar um código.
- Diga os 6 dígitos ao agente, por exemplo "envie o build para o meu celular, código 482913".
- O agente chama
send_files. O celular pede que você aceite e depois oferece Salvar para cada arquivo, ou mostra a mensagem com um botão Copiar.
A mesma ferramenta envia para outro computador que execute tosstome listen quando recebe o link da caixa de entrada dele em vez de um código.
O que você precisa saber
- Os arquivos vão de dispositivo para dispositivo, ou por um relay que não guarda nada. Se o celular ou o computador estiver offline, nada é enviado.
- Um processo por vez deve manter a caixa de entrada. Se o
tosstome listenjá estiver em execução para a mesma caixa de entrada, pare-o enquanto o agente usa otosstome mcp, ou os arquivos podem ir para qualquer um dos dois. - Qualquer pessoa com o link da caixa de entrada pode enviar arquivos ao agente. O servidor instrui o agente a tratar o conteúdo dos arquivos como dados, e não como instruções, mas tenha cuidado com quem recebe o link. O
tosstome listen --newsubstitui um link que vazou. - O servidor aceita tanto a revisão MCP atual sem estado (2026-07-28) quanto clientes que ainda usam o handshake
initialize.
Perguntas
Com quais agentes funciona?
Com qualquer cliente MCP capaz de iniciar um servidor stdio, incluindo Claude Code, Cursor, Claude Desktop e outros. O servidor é o comando tosstome mcp.
Posso enviar texto ao agente em vez de um arquivo?
Sim. Digite ou cole na caixa de mensagem da página da caixa de entrada. O wait_for_files devolve o texto inline e também o salva como um arquivo .txt. O agente pode enviar texto de volta ao seu celular com send_files e o argumento text.
O agente consegue ver minhas capturas de tela?
Sim. O wait_for_files devolve arquivos PNG, JPEG, GIF e WebP com menos de 3,5 MB como conteúdo de imagem, então um modelo que lê imagens as vê diretamente. Arquivos maiores voltam como caminhos.
Os arquivos passam por algum serviço na nuvem?
Não. Os arquivos vão direto entre os dispositivos por WebRTC quando possível; caso contrário, passam por um relay na Cloudflare que os repassa conforme chegam e não guarda nada. Isso vale também para a caixa de entrada do agente: quando o celular está no mesmo Wi-Fi que o computador, as capturas de tela vão direto para ele pela rede local.
Meu celular precisa de um app?
Não. O celular usa a página da caixa de entrada ou o toss2.me no navegador.
Relacionados
- A ferramenta de linha de comando do tosstome
- Enviar arquivos do celular para um servidor, NAS ou Raspberry Pi
- Enviar arquivos do celular para o computador
- Como o tosstome funciona
Experimente agora
Abra o toss2.me em dois dispositivos. Sem app, sem conta e sem guardar nada.
Enviar um arquivo agora