Pular para o conteúdo
DOTWICK

Servidor MCP

O que é

O Model Context Protocol (MCP) é um padrão aberto que permite a um assistente de IA chamar ferramentas em outro serviço. A Dotwick mantém um servidor MCP para que um assistente possa listar seus códigos, criar e alterá-los, etiquetá-los e ler os números dos seus escaneamentos.

O servidor é uma camada fina sobre esta API. Cada uma das suas 11 ferramentas chama uma rota da API com o escopo dessa rota, sob os mesmos limites de requisições, então um assistente pode fazer o que a chave dele faria à mão e nada além. Nada apaga: remover códigos, pastas e tags continua no app e na API REST, então nenhum prompt consegue quebrar um código impresso.

Antes de começar

O MCP vem com o acesso à API (Pro, Business e Enterprise). No app, abra Settings → API e crie uma chave com os escopos de que o assistente precisa: os escopos de leitura bastam para perguntas sobre seus escaneamentos, e codes:write, folders:write ou tags:write permitem que ele mude coisas.

O assistente só vê as ferramentas que a chave dele permite, então uma chave somente leitura nunca lista create_code. Cada chamada de ferramenta conta como uma requisição de API no limite de requisições e no total mensal da chave; listar as ferramentas não.

Conecte

O servidor fala Streamable HTTP em https://api.dotwick.com/mcp. Envie a chave como bearer token no cabeçalho Authorization.

exemploAdicione o servidor
claude mcp add --transport http dotwick https://api.dotwick.com/mcp \  --header "Authorization: Bearer $DOTWICK_API_KEY"

Claude, ChatGPT e outros clientes

O Claude Code adiciona o servidor com o comando acima. Clientes que leem um arquivo de configuração do MCP, como o Cursor e o VS Code, usam o bloco JSON: guarde a chave em uma variável de ambiente e se refira a ela, nunca a escreva no arquivo.

O ChatGPT e outros apps que adicionam um servidor MCP remoto pela URL: informe a URL do servidor e envie a chave como bearer token onde o app pedir uma chave de API ou um cabeçalho. Um app que só consegue entrar com OAuth ainda não consegue se conectar. O OAuth está planejado; hoje o servidor é acessado por chaves de API.

Ferramentas

Cada ferramenta corresponde a uma rota da API e exige o escopo dessa rota. As ferramentas de listagem devolvem até 50 itens e um cursor para a próxima página.

list_codes
Lista os QR codes do espaço de trabalho, do mais recente ao mais antigo. Filtre por pasta, tags, tipo, status ou busque no nome e no link curto.codes:read · GET /v1/codes
get_code
Um QR code com destino, regras, tags e total de escaneamentos.codes:read · GET /v1/codes/{id}
create_code
Cria um QR code que abre uma página da web. Dinâmico por padrão (o destino pode mudar depois de impresso). Pasta, tags e parâmetros UTM opcionais.codes:write · POST /v1/codes
update_code
Altera o nome, a URL de destino, a pasta, as tags ou a data de expiração de um código, ou o pausa e o retoma.codes:write · PATCH /v1/codes/{id}
list_folders
As pastas do espaço de trabalho.folders:read · GET /v1/folders
create_folder
Cria uma pasta, opcionalmente dentro de outra.folders:write · POST /v1/folders
list_tags
As tags do espaço de trabalho e quantos códigos têm cada uma.tags:read · GET /v1/tags
create_tag
Cria uma tag com nome e cor.tags:write · POST /v1/tags
tag_codes
Adiciona ou remove tags em até 500 códigos de uma vez.codes:write · POST /v1/codes/tags
analytics_summary
Total de escaneamentos e únicos em um período: o espaço de trabalho, um código, uma pasta ou uma tag.analytics:read · GET /v1/analytics/summary
analytics_breakdown
Principais países, cidades, dispositivos, navegadores, códigos ou variantes A/B em um período.analytics:read · GET /v1/analytics/breakdown

Limites e segurança

  • A chave mantém a restrição de pasta, os intervalos de IP e os limites de requisições: pelo MCP ela só vê o que vê pela API REST.
  • Nada pode ser apagado pelo MCP.
  • Um assistente pode errar. Peça que ele diga o que vai mudar antes de escrever e confira o resultado no app.