Jamdesk Documentation logo

Menu de ações de IA

Um menu suspenso em cada página que permite copiar o Markdown, abrir páginas no ChatGPT, Claude ou Perplexity, ou instalar seu servidor MCP com um clique.

Toda página do seu site Jamdesk tem um menu de Ações de IA, um pequeno menu suspenso acima do título. Os leitores podem copiar a página em Markdown, abri-la no ChatGPT ou instalar seu servidor MCP no Cursor. Nenhuma configuração é necessária.

As capturas de tela mostram a interface em inglês.

AI Actions dropdown showing Copy page, View as Markdown, Download API spec, Open in ChatGPT, Open in Claude, Open in Perplexity, Copy MCP config, Connect to Cursor, and Connect to VS Code options

Opções integradas

O menu vem com oito opções, todas ativadas por padrão:

OpçãoChaveO que faz
Copy pagecopyBusca o Markdown bruto e o copia para a área de transferência
View as MarkdownviewAbre o arquivo .md em uma nova aba
Open in ChatGPTchatgptAbre o ChatGPT com um prompt para ler a página atual
Open in ClaudeclaudeAbre o Claude com o mesmo prompt
Open in PerplexityperplexityAbre o Perplexity com o mesmo prompt
Copy MCP configmcpCopia a configuração JSON do seu servidor MCP do site
Add to CursorcursorCria um link direto para instalar o servidor MCP no Cursor
Add to VS CodevscodeCria um link direto para instalar o servidor MCP no VS Code

O Gemini também está disponível como gemini. Ele não faz parte dos padrões porque não preenche prompts de forma confiável a partir de uma URL. Adicione-o explicitamente se seus leitores o utilizarem.

copy se torna o botão principal quando está na lista de opções. As demais aparecem em um menu suspenso atrás de um chevron. Sem copy, o menu se recolhe em um único menu suspenso "AI Actions".

Baixar especificação da API

As páginas de referência de API recebem mais um item: Download API spec. Ele agrupa todas as especificações OpenAPI que seu site referencia em um único api-specs.zip, incluindo URLs de especificações remotas. Entregue o zip ao Postman, a um gerador de clientes ou às suas próprias ferramentas. Especificações com múltiplos arquivos mantêm a estrutura de pastas dentro do zip. Os links $ref entre arquivos continuam sendo resolvidos.

Não há nada a configurar. O item aparece apenas em páginas baseadas em uma especificação OpenAPI. A Jamdesk gera o zip novamente a cada download, por isso ele sempre corresponde às suas especificações atuais.

Configuração

Edite o docs.json somente para alterar quais opções aparecem ou para desativar o menu.

Mostrar um subconjunto de opções

docs.json
{
  "contextual": {
    "options": ["copy", "claude", "mcp"]
  }
}

Desativar o menu

docs.json
{
  "contextual": {
    "enabled": false
  }
}

Adicionar opções personalizadas

Combine opções integradas com as suas próprias. Uma opção personalizada abre sua URL em uma nova aba.

docs.json
{
  "contextual": {
    "options": [
      "copy",
      "claude",
      {
        "title": "Ask on Discord",
        "description": "Get help from the community",
        "icon": "discord",
        "href": "https://discord.gg/your-server"
      }
    ]
  }
}

As opções personalizadas aceitam um campo icon opcional. Qualquer nome de ícone do Font Awesome funciona, incluindo ícones de marcas como discord ou slack. Opções sem ícone exibem um ícone de link.

As opções personalizadas também aceitam parâmetros de consulta:

docs.json
{
  "contextual": {
    "options": [
      "copy",
      {
        "title": "Search in Notion",
        "description": "Find related internal docs",
        "href": {
          "base": "https://notion.so/search",
          "query": [
            { "key": "q", "value": "docs" }
          ]
        }
      }
    ]
  }
}

Como funciona

O menu é executado no lado do cliente. Suas URLs são atualizadas a cada navegação entre páginas, incluindo a navegação pela barra lateral, sem recarregar a página inteira. O link "Open in Claude" sempre aponta para a página atual.

Os links dos serviços de IA colocam a URL .md da página no prompt. ChatGPT, Claude e Perplexity buscam a página a partir desse link.

As opções MCP usam o endpoint /_mcp em todo site Jamdesk. "Copy MCP config" copia o JSON para qualquer cliente MCP. "Add to Cursor" e "Add to VS Code" são links diretos que abrem o fluxo de instalação do editor. Veja Servidor MCP para saber o que as ferramentas de IA podem fazer com ele.

Servidor MCP

Todo site Jamdesk tem um servidor MCP integrado. Conecte-se a ele pelo menu de Ações de IA.