Configuração comum

Shayan TaslimAtualizado

O UserJot não requer um pacote MCP local. Ligue o seu cliente diretamente ao URL do servidor MCP remoto do UserJot e, em seguida, inicie sessão com OAuth ou forneça um token de API.

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

Iniciar sessão com OAuth (recomendado)

Aceda a Definições → MCP & API no painel do UserJot para encontrar botões de instalação com um clique e comandos que pode copiar. Quando o seu cliente lhe pedir para iniciar sessão, o browser abre o UserJot para que possa escolher um espaço de trabalho e clicar em Permitir.

  • Claude (web, computador e dispositivos móveis): Selecione Claude em Definições → MCP & API e clique em Adicionar ao Claude. O Claude abre com o conector pré-preenchido; confirme clicando em Adicionar e inicie sessão.

  • VS Code (modo de agente do Copilot): Abra Mais → VS Code em Definições → MCP & API e clique em Adicionar ao VS Code. Em seguida, confirme Instalar e inicie sessão.

  • Gemini CLI: Abra Mais → Gemini CLI em Definições → MCP & API, ou execute este comando no terminal e, em seguida, execute /mcp auth userjot no Gemini CLI para iniciar sessão:

Bash
gemini mcp add --transport http --scope user userjot https://api.userjot.com/v1/mcp

As aplicações ligadas aparecem em Aplicações ligadas, em Definições → MCP & API, com o nome do proprietário ou administrador que as autorizou. Uma aplicação ligada só permanece ativa enquanto essa pessoa for proprietária ou administradora do espaço de trabalho. Utilize Mantenha premido para revogar para interromper imediatamente o acesso.

Utilizar um token de API

Para clientes que requerem um cabeçalho personalizado (como o Windsurf) ou ambientes sem interface gráfica, crie um token em Definições → MCP & API e forneça:

text
Server URL:    https://api.userjot.com/v1/mcp
Authorization: Bearer YOUR_USERJOT_API_TOKEN

A maioria dos clientes MCP HTTP remotos aceita uma configuração JSON como esta (nos clientes OAuth, omita o bloco headers):

JSON
{
  "mcpServers": {
    "userjot": {
      "type": "http",
      "url": "https://api.userjot.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_USERJOT_API_TOKEN"
      }
    }
  }
}

Verificar a ligação

Depois de estabelecer a ligação, peça ao seu cliente para inspecionar o servidor userjot ou chamar getWorkspace. Se a ligação funcionar, o cliente apresentará os detalhes do seu espaço de trabalho e as ferramentas disponíveis, sem necessidade de configuração local.

Resolução de problemas

Se a ligação falhar, comece por verificar estes pontos:

  • Se iniciou sessão com OAuth, confirme que a aplicação continua listada em Aplicações ligadas, em Definições → MCP & API, e que continua a ser proprietário ou administrador do espaço de trabalho.

  • Se utilizar um token de API, confirme que o token não foi revogado e que o cabeçalho Authorization começa com Bearer.

  • Confirme que o seu cliente suporta servidores MCP HTTP remotos (Streamable HTTP).

  • Confirme que o ficheiro de configuração está na localização correta e reinicie o cliente depois de o editar.

  • Verifique se atingiu o limite de pedidos da API do seu plano.

Próximos passos

  • Consulte as 98 ferramentas disponíveis e os detalhes de segurança em Visão geral do MCP.

  • Utilize a API REST se estiver a escrever código diretamente para o backend.

Isto respondeu à sua pergunta?