Visão geral do MCP
O servidor MCP do UserJot permite que as ferramentas de IA se liguem diretamente ao seu espaço de trabalho UserJot através de HTTP remoto, sem necessidade de instalar um pacote local ou um processo de ligação.
URL do servidor
O UserJot disponibiliza um único endpoint MCP remoto:
https://api.userjot.com/v1/mcpAutenticação
A maioria dos clientes MCP modernos suporta o início de sessão com OAuth diretamente. Cole o URL do servidor (ou use o botão ou comando de instalação com um clique em Definições → MCP & API; VS Code e Gemini CLI encontram-se no menu Mais), inicie sessão no UserJot, escolha o seu espaço de trabalho e clique em Permitir.
Cliente | Método de autenticação recomendado | Guia de configuração |
|---|---|---|
Claude (web, desktop, mobile) | OAuth (com um clique em Settings → MCP & API) | |
Claude Code | OAuth (ou token de API) | |
Cursor | OAuth (com um clique em Settings → MCP & API) ou token de API | |
Codex | OAuth (ou token de API) | |
ChatGPT | OAuth (ou token de API na versão para computador) | |
VS Code (Copilot) | OAuth (em Mais, em Definições → MCP & API) | |
Gemini CLI | OAuth (em Mais, em Definições → MCP & API) | |
Windsurf & ferramentas sem interface/CI | Cabeçalho com token de API |
As aplicações ligadas através de OAuth aparecem em Aplicações ligadas, em Definições → MCP & API, onde pode ver quem ligou cada aplicação. Use Mantenha premido para revogar para cortar o acesso de uma aplicação no pedido seguinte.
Só os proprietários e administradores do espaço de trabalho podem ligar uma aplicação OAuth, e uma aplicação ligada só continua a funcionar enquanto a pessoa que a ligou for proprietária ou administradora.
Para clientes que exigem um cabeçalho estático ou para scripts automatizados, crie um token de API em Settings → MCP & API e envie:
Authorization: Bearer YOUR_USERJOT_API_TOKENO que o servidor MCP pode fazer
O servidor MCP remoto disponibiliza 98 ferramentas que abrangem os dados e os fluxos de trabalho do seu espaço de trabalho (duas operações REST — createAsset carregamento multipart e deleteMember eliminação ao abrigo do RGPD — estão disponíveis apenas através de REST):
Espaço de trabalho e quadros: Consulte os metadados do espaço de trabalho e crie, liste, atualize ou elimine quadros.
Pedidos, comentários, votos e etiquetas: Liste, crie, atualize, mova e combine pedidos, desfaça combinações, encontre pedidos semelhantes, faça a gestão de subscrições, publique e fixe comentários, adicione ou remova votos, faça a gestão de etiquetas e anexe imagens.
Registo de alterações: Liste, crie, atualize e elimine entradas, e faça a gestão dos pedidos, autores e etiquetas associados.
Conversas: Listar, ler e iniciar conversas de saída (
createConversationrequer um plano pago: 5/dia no Starter, 15/dia no Professional), ler cronologias, publicar respostas e notas internas e atualizar o estado ou o responsável.Membros e empresas: Procure, liste, sincronize e atualize membros e empresas, e faça a gestão das associações a empresas.
Centro de ajuda: Crie, atualize, elimine, publique e retire de publicação coleções e artigos, e pesquise-os.
Recursos: Importar imagens remotas ou criar carregamentos pré-assinados para utilizar nos registos de alterações e nos artigos de ajuda.
Todas as ferramentas de escrita e eliminação têm permissões completas no espaço de trabalho e estão identificadas como destrutivas, para que os clientes peçam confirmação antes de alterar dados.
Limites de pedidos e acesso por plano
O MCP está disponível em todos os planos, incluindo o Free. As chamadas às ferramentas partilham os limites de pedidos da API REST do seu espaço de trabalho: 10 pedidos/min (150/h) no Free, 60 pedidos/min (1 500/h) no Starter e 120 pedidos/min (5 000/h) no Professional. As sessões intensivas com agentes podem atingir rapidamente o limite do Free.
MCP vs. API REST
Use o MCP para ligar um assistente de IA ou uma ferramenta de programação compatível com o Model Context Protocol. Use a API REST para criar a sua própria integração de back-end, script ou código de aplicação.
Gestão de tokens
Se usar um token de API em vez de OAuth, trate-o como qualquer outro segredo:
Não o inclua diretamente em ficheiros de configuração enviados para o repositório.
Prefira variáveis de ambiente ou um gestor de segredos local.
Use tokens separados para diferentes ambientes ou colegas de equipa.
Revogue os tokens não utilizados em Definições → MCP & API utilizando Mantenha premido para revogar.
Próximos passos
Siga a Configuração comum para configurar OAuth, Claude web/desktop, VS Code, Gemini CLI ou uma configuração JSON genérica.
Aceda diretamente às instruções para Claude Code, Cursor, Codex, ChatGPT ou Windsurf.