count
um livro-razão de despesas compartilhadas que seu agente opera. mcp remoto hospedado — cole uma url no claude, chatgpt ou cursor. sem repositório, sem processo local, sem chave de api para gerar. todos os outros no count recebem um link de compartilhamento sem cadastro. ferramentas: create_count, add_expense, get_balances, settle, add_member, list_counts. grátis.
Documentação
seis ferramentas. uma url. nenhuma api key para criar.
count é um servidor mcp remoto hospedado sobre http streamable. não há repositório para clonar, nenhum processo para manter vivo no seu laptop, e as outras pessoas no seu count nunca criam uma conta.
prove que está ativo
$ curl -s https://count.nanocorp.app/mcp/k_your_key
{
"name": "count",
"status": "ok",
"transport": "streamable-http",
"protocolVersion": "2025-06-18",
"tools": [
"create_count", "add_expense",
"get_balances", "list_counts",
"settle", "add_member"
]
}
o próprio mcp fala json-rpc sobre post para a mesma url. seu agente cuida dessa parte.
conecte
cole a url. essa é a integração inteira.
claude
- 01configurações → conectores
- 02adicionar conector personalizado
- 03cole a url, clique em adicionar
free, pro, max e team. no team, um proprietário adiciona primeiro nas configurações da organização.
chatgpt
- 01configurações → conectores → configurações avançadas
- 02ative o modo desenvolvedor
- 03criar → cole a url → sem autenticação → escanear ferramentas
no plus e pro, os conectores do chatgpt leem mas não escrevem hoje. peça saldos; escreva pelo claude, cursor ou pelo ledger web.
cursor
- 01abra ~/.cursor/mcp.json
- 02{"mcpServers":{"count":{"url":"…"}}}
- 03reinicie o cursor
um .cursor/mcp.json por repositório também funciona. deixe de fora qualquer campo type.
tutorial mais longo para claude, com as quatro telas e o que dizer primeiro: conecte claude a despesas compartilhadas
nenhuma key
ou cole a url pura e pule esta página.
https://count.nanocorp.app/mcp não exige key. adicione como conector e a primeira coisa que você disser abre um ledger. esta é a url nos diretórios, porque um diretório só pode carregar um endereço e tudo depois de /mcp/ é pessoal.
o detalhe, dito uma vez e claramente: esse ledger está vinculado à conversa em que você o abriu. então o primeiro resultado da ferramenta entrega sua própria url com key e diz para você trocá-la. faça isso e o count é seu de qualquer lugar. ignore e o count ainda existe — seu link de compartilhamento funciona para sempre — mas uma nova conversa na url pura começa uma vazia.
se você preferir ter a url permanente primeiro, pegue sua key e cole essa em vez disso. mesmas ferramentas, mesmo preço, sem troca depois.
o que a primeira chamada responde
made "flat" with 3 members: you, maya,
theo. share link: https://count.nanocorp.app/c/…
no signup for anyone who opens it.
this ledger is new and reachable from
this conversation only. to keep it,
paste https://count.nanocorp.app/mcp/k_…
into your connector settings in place
of https://count.nanocorp.app/mcp
as ferramentas
cada ferramenta, seus argumentos e o que retorna.
name
string, obrigatório
o que este count é: "flat", "viagem a tahoe"
members
string[]
as outras pessoas, pelo primeiro nome
currency
string
USD, EUR ou GBP. o padrão é USD
você diz
"crie um count para meu flat com maya e theo"
a ferramenta retorna
criado "flat" com 3 membros: você, maya, theo. link de compartilhamento: https://count.nanocorp.app/c/hq7fn2mkxd sem cadastro para quem abrir.
add_expense
Registra uma despesa compartilhada e retorna o novo saldo de cada membro.
description
string, obrigatório
no que o dinheiro foi gasto
amount
number|string, obrigatório
o total pago, 184.20
count
string
nome ou link. opcional se você tiver um count
paid_by
string
membro que pagou. o padrão é você
split_between
string[]
membros para dividir igualmente. o padrão é todos
shares
object
divisão desigual: {"maya": 40, "theo": 20}
você diz
"paguei $184.20 em compras, dividido em três"
a ferramenta retorna
registrado. compras, $184.20, pago por você. maya te deve $61.40. theo te deve $61.40.
get_balances
Lê quem deve a quem, mais as últimas cinco linhas. Sem escritas.
count
string
nome ou link
você diz
"quanto devo no count do flat"
a ferramenta retorna
flat: 3 membros, você, maya, theo. maya te deve $61.40. theo te deve $61.40. recente: 2026-08-22 compras $184.20 pago por você. link: https://count.nanocorp.app/c/hq7fn2mkxd
list_counts
Lista seus counts, cada um com seu próprio saldo e seu link. Sem escritas.
sem argumentos.
você diz
"quais counts eu tenho"
a ferramenta retorna
2 counts. flat — te devem $122.80 — https://count.nanocorp.app/c/hq7fn2mkxd | viagem a tahoe — zerado — https://count.nanocorp.app/c/w9dz4qm3rk
settle
Registra que dinheiro mudou de mãos fora do count. Omita amount para quitar integralmente.
from
string, obrigatório
membro que pagou o dinheiro
to
string, obrigatório
membro que recebeu
amount
number|string
omitir para limpar o que devem
count
string
nome ou link
você diz
"maya me pagou de volta $61.40"
a ferramenta retorna
quitado. maya te pagou $61.40 fora do count. theo te deve $61.40.
add_member
Adiciona uma pessoa a um count existente.
name
string, obrigatório
o primeiro nome dela
count
string
nome ou link
você diz
"adicione priya à viagem a tahoe"
a ferramenta retorna
priya adicionada à viagem a tahoe. os membros são: você, maya, theo, priya.
limites, claramente
- free cobre 3 counts em uma key. um quarto precisa da licença vitalícia, $29.00, uma vez — o que é isso. os counts que você já tem nunca são tirados de você.
- count registra quem deve a quem. ele não guarda, move ou transfere fundos, e nenhuma ferramenta vai afirmar que faz.
- um link de compartilhamento é a única credencial que um count tem. qualquer um com ele pode ler e escrever. qualquer membro pode substituí-lo pela página do count.
- uma moeda por count, definida quando é criado. count não converte.
solução de problemas
não está conectando.
o cliente rejeita a url, ou não lista ferramentas
rode o curl acima. se responder com os nomes das ferramentas, o endpoint está ativo e o problema está no cliente. cole a url novamente sem barra no final e nada depois da key.
o chatgpt vê as ferramentas mas não escreve
esperado no plus e pro: conectores em modo desenvolvedor só leem hoje. escrever exige um plano business. use claude ou cursor para escrever, ou o ledger web do próprio count.
status diz "unknown key"
a key foi substituída. abra o link de compartilhamento de qualquer count, reivindique seu nome de membro e crie uma nova em /key. a key antiga para de funcionar no momento em que a nova existe.
uma ferramenta respondeu com uma frase simples em vez de executar
esse é o design. toda falha retorna como uma frase que seu agente pode ler em voz alta, e nada é escrito quando isso acontece. uma falha silenciosa em um ledger de dinheiro é pior que uma interrupção.
ainda travado: envie um e-mail para hello@count.nanocorp.app.