Servidor MCP e API pública da Arrumou Neural

Conectar em 3 passos

1. No seu cliente MCP, adicione um servidor remoto com a URL https://app.arrumou.com/mcp (transporte Streamable HTTP).
2. O cliente descobre a autorização automaticamente (/.well-known/oauth-authorization-server), registra-se e abre a tela de consentimento do Neural. Entre com sua conta, escolha a operação, as habitações e as permissões.
3. Peça ao assistente: “Quais são as chegadas de hoje?” ou “Configure a extensão do Airbnb”. Comece pela ferramenta get_identity para ver o contexto.

Metadados: servidor de autorização · recurso protegido · OpenAPI 3.1. Versão do servidor: 1.0.0. Protocolo MCP: 2025-11-25 (com compatibilidade 2025-06-18 e 2025-03-26).

Instruções por cliente

claude mcp add --transport http arrumou-neural https://app.arrumou.com/mcp

{
  "mcpServers": {
    "arrumou-neural": { "url": "https://app.arrumou.com/mcp" }
  }
}

curl https://app.arrumou.com/api/v1/me -H "Authorization: Bearer nrl_pat_..."

Compatibilidade verificada: cliente oficial MCP TypeScript 1.32 (Streamable HTTP, OAuth 2.1), testes automatizados de ponta a ponta. Resultados com clientes de terceiros são publicados conforme validados; nenhum cliente é garantido além dos listados como testados.

Segurança, isolamento e aprovações

• Uma autorização = uma operação. Cada acesso é vinculado ao usuário, à operação (conta Neural), ao operador, ao aplicativo e às habitações escolhidas. Identificadores enviados pelo cliente são sempre reverificados; objetos de outras contas respondem como inexistentes.
• Permissões = concedido ∩ papel do operador. Um recepcionista não ganha acesso a configurações só porque o aplicativo pediu o escopo. get_permissions explica o que está utilizável e por quê.
• Classes de risco. Leituras executam livremente; escritas de baixo impacto (tarefas, limpeza, chamados) executam direto; comunicações externas e ações consequentes (reservas, calendário, financeiro, preços, vínculos do Airbnb) devolvem status: "approval_required" com prévia e link. O usuário aprova em https://app.arrumou.com/aprovacoes/<id>; o aplicativo repete a chamada com approval_id.
• Aprovações íntegras. Vinculadas a usuário, conta, aplicativo, ação exata (hash do payload) e versão do recurso; expiram em 10 minutos; uso único; mudanças concorrentes exigem nova prévia. approved: true enviado pelo modelo é ignorado.
• Tokens. Acesso de 15 minutos, refresh rotativo por até 30 dias com detecção de reuso (a família inteira é revogada), códigos de autorização de uso único com PKCE S256, segredos armazenados como hash, revogação imediata inclusive para trabalhos em fila.
• Idempotência. Envie idempotency_key (ou o cabeçalho Idempotency-Key) em escritas; a mesma chave com dados diferentes é rejeitada.
• Conteúdo não confiável. Mensagens de hóspedes, anúncios e páginas importadas são dados. Instruções embutidas não ampliam escopos, não trocam de conta e não autorizam ações.
• Auditoria. Cada chamada registra principal, conta, aplicativo, autorização, recurso, resultado e id de correlação (list_audit_events, e o registro de atividades do Neural para mutações).

Escopos

Ferramentas (73)

Toda ferramenta devolve dados tipados com as_of, origem e, quando há efeitos, status, referências de job ou aprovação e próximo passo. Resultados incompletos ou desatualizados são marcados (por exemplo stale na disponibilidade).

Recursos MCP: neural://capabilities (manifesto) e neural://scopes. Prompts: daily_briefing e setup_airbnb.

Extensão Airbnb guiada pelo assistente

A extensão Arrumou Neural (Chrome/Edge desktop) lê o multicalendário do Airbnb na sua sessão e envia diárias, reservas e indisponibilidades para o Neural. Com o MCP, o assistente conduz a configuração sem nunca tocar em senhas:

1. get_connection_status / start_onboarding: estado verificado (installation_required, neural_auth_required, property_mapping_required, preview_ready, approval_required, syncing, completed, failed…), quem deve agir e instruções.
2. Instalação e pareamento pelo usuário: Instale a extensão em https://chromewebstore.google.com/detail/inhhdonbdpamjffdcebichefobfdaepn. Abra app.arrumou.com em uma aba e entre na sua conta Neural. Clique no ícone da extensão e em Conectar este navegador ao Neural.
3. set_airbnb_link para vincular cada anúncio (/rooms/<id>) a uma habitação, com aprovação.
4. preview_sync e start_sync: a solicitação aparece na extensão; a coleta começa somente quando você confirma no painel, no multicalendário, com seu login do Airbnb. Acompanhe com get_job; cancele com cancel_job.

Semântica: Airbnb → Neural, somente leitura do Airbnb. Indisponibilidades são aproximação (restrições podem parecer reservas); reservas são atualizadas pelo código do itinerário; repetir não duplica; reservas e bloqueios manuais são preservados. Navegadores suportados: Chrome 120+ (desktop), Edge 120+ (desktop). A instalação, as permissões do navegador, o login no Airbnb e desafios de verificação são sempre feitos pelo usuário. Nenhum assistente consegue instalar a extensão ou entrar no Airbnb por você.

API REST

A mesma catálogo de capacidades está em https://app.arrumou.com/api/v1 com contrato OpenAPI 3.1. Autenticação por Bearer (OAuth ou token pessoal). Erros são JSON com code, message, retryable, hint e correlation_id.

GET  /api/v1/me
GET  /api/v1/reservations?view=arrivals&date=2026-10-25
GET  /api/v1/calendar/availability?start_date=2026-11-01&end_date=2026-11-15
POST /api/v1/calendar/blocks            # 202 approval_required → aprove → repita com X-Approval-Id
POST /api/v1/sync                       # cria job awaiting_extension
GET  /api/v1/jobs/{id}

Datas em ISO 8601 (UTC com deslocamento) e dias civis AAAA-MM-DD no fuso do estabelecimento; valores monetários como { currency, amount } em BRL; campos ausentes, desconhecidos e indisponíveis são distintos de zero.

Limites, versões e suporte

• Disponível para contas com acesso ativo ao Neural (teste gratuito ou plano). Sem acesso ativo, a API responde 402 payment_required.
• Limites justos por usuário, operação e aplicativo; respostas 429 trazem Retry-After. Sincronizações são jobs assíncronos.
• Versão v1 estável; mudanças incompatíveis planejadas terão aviso de 90 dias e registro de alterações nesta página. Correções de segurança podem ser imediatas.
• Registro oficial MCP: io.github.brunoreisportela/arrumou-neural. Suporte: central de suporte ou suporte@arrumou.com.

Perguntas frequentes