Visão geral do MCP

Shayan TaslimAtualizado

O servidor MCP do UserJot permite que ferramentas de IA se conectem diretamente ao seu espaço de trabalho do UserJot por HTTP remoto, sem precisar instalar um pacote local ou um processo de ponte.

URL do servidor

O UserJot disponibiliza um endpoint MCP remoto:

text
https://api.userjot.com/v1/mcp

Autenticação

A maioria dos clientes MCP modernos oferece suporte direto ao login com OAuth. Cole a URL do servidor (ou use o botão de instalação com um clique ou o comando em Configurações → MCP & API; VS Code e Gemini CLI ficam no menu Mais), entre no UserJot, escolha seu espaço de trabalho e clique em Permitir.

Cliente

Autenticação recomendada

Guia de configuração

Claude (web, desktop e celular)

OAuth (instalação com um clique em Configurações → MCP & API)

Configuração comum

Claude Code

OAuth (ou token de API)

Claude Code

Cursor

OAuth (instalação com um clique em Configurações → MCP & API) ou token de API

Cursor

Codex

OAuth (ou token de API)

Codex

ChatGPT

OAuth (ou token de API no desktop)

ChatGPT

VS Code (Copilot)

OAuth (em Mais, em Configurações → MCP & API)

Configuração comum

Gemini CLI

OAuth (em Mais, em Configurações → MCP & API)

Configuração comum

Windsurf e ferramentas headless/CI

Cabeçalho com token de API

Windsurf / Configuração comum

Os apps conectados via OAuth aparecem em Apps conectados, em Configurações → MCP & API, mostrando quem conectou cada app. Use Mantenha pressionado para revogar para cortar o acesso de um app na próxima solicitação.

Note

Somente proprietários e administradores do espaço de trabalho podem conectar um app OAuth. Um app conectado continua funcionando apenas enquanto a pessoa que o conectou permanecer como proprietária ou administradora.

Para clientes que exigem um cabeçalho estático ou scripts automatizados, crie um token de API em Configurações → MCP & API e envie:

text
Authorization: Bearer YOUR_USERJOT_API_TOKEN

O que o servidor MCP pode fazer

O servidor MCP remoto disponibiliza 98 ferramentas que abrangem os dados e fluxos de trabalho do seu espaço de trabalho (duas operações REST, o upload multipartes createAsset e a exclusão de dados conforme o GDPR deleteMember, estão disponíveis apenas via REST):

  • Espaço de trabalho e quadros: consulte os metadados do espaço de trabalho e crie, liste, atualize ou exclua quadros.

  • Solicitações, comentários, votos e tags: liste, crie, atualize, mova e mescle solicitações; desfaça mesclagens; encontre solicitações semelhantes; gerencie inscrições; publique ou fixe comentários; adicione ou remova votos; gerencie tags; e anexe imagens.

  • Changelog: liste, crie, atualize e exclua entradas, e gerencie solicitações vinculadas, autores e tags.

  • Conversas: Liste, leia e inicie conversas de saída (createConversation exige um plano pago: 5/dia no Starter, 15/dia no Professional), leia linhas do tempo, publique respostas e notas internas e atualize o status ou responsável.

  • Membros e empresas: consulte, liste, sincronize e atualize membros e empresas, e gerencie as associações a empresas.

  • Central de Ajuda: crie, atualize, exclua, publique e retire de publicação coleções e artigos, além de pesquisá-los.

  • Arquivos: Importe imagens remotas ou crie uploads pré-assinados para usar em registros de alterações e artigos de ajuda.

Todas as ferramentas de gravação e exclusão têm permissões completas no espaço de trabalho e são marcadas como destrutivas para que os clientes solicitem confirmação antes de alterar dados.

Limites de taxa e acesso por plano

O MCP está disponível em todos os planos, incluindo o Free. As chamadas de ferramentas compartilham os limites de taxa da API REST do seu espaço de trabalho: 10 solicitações/min (150/h) no Free, 60 solicitações/min (1.500/h) no Starter e 120 solicitações/min (5.000/h) no Professional. Sessões intensas com agentes podem atingir rapidamente o limite do Free.

MCP vs. API REST

Use o MCP ao conectar um assistente de IA ou uma ferramenta de programação compatível com o Model Context Protocol. Use a API REST ao desenvolver sua própria integração de backend, script ou código de aplicativo.

Como gerenciar tokens

Se você usar um token de API em vez de OAuth, trate-o como qualquer outro segredo:

  • Não o inclua diretamente em arquivos de configuração versionados.

  • Prefira variáveis de ambiente ou um gerenciador de segredos local.

  • Use tokens separados para diferentes ambientes ou colegas de equipe.

  • Revogue tokens não utilizados em Configurações → MCP & API usando Mantenha pressionado para revogar.

Próximas etapas

Isso respondeu à sua pergunta?