• PRONTO
  • ESPECÍFICO
  • VERIFICADO
  • MANUAL

Como gerar tokens de acesso API com sua IA

Conecte o Forgejo ao seu cliente de IA uma única vez. Depois disso, você gerencia o acesso aos repositórios por comandos simples de chat.

Pergunte à IA sobre esta página

Resposta rápida

Como crio um novo token de API para meu repo no Forgejo?

Basta dizer à sua IA qual repositório precisa de acesso e quais permissões conceder. Ela usa a ferramenta create_token para gerar um token de acesso pessoal com escopo imediato. Você receberá a string do token para usar em seus scripts ou CLI.

Resultados da geração de tokens

O que você recebe da sua IA

Os resultados dos seus comandos por conversa.

PRONTO

Novo token criado

A IA usa o create_token para gerar uma string única. Você recebe o texto do token para copiar para suas variáveis de ambiente.

ESPECÍFICO

Permissões definidas

A IA aplica apenas os escopos que você solicitou. Isso mantém seus repositórios seguros ao limitar o que o token pode acessar.

VERIFICADO

Confirmação de escopo

Sua IA confirma exatamente quais permissões foram aplicadas ao novo token. Você pode conferir a lógica antes de usar.

MANUAL

Armazenamento manual

A IA fornece o token, mas você deve salvá-lo. Ela não armazena seus segredos nem os mantém em um banco de dados.

O fluxo

O que sua IA faz ao pedir um token.

A IA traduz seu pedido em linguagem natural para uma chamada de API específica.

  1. Identificar o alvo

    Sua IA analisa seu pedido para encontrar o repositório Forgejo específico que você quer acessar.

    create_token

  2. Definir permissões

    A IA mapeia termos como 'apenas leitura' ou 'acesso de escrita' para os escopos técnicos corretos.

    create_token

  3. Executar geração

    A IA chama a ferramenta específica para criar o token com as configurações escolhidas.

    create_token

  4. Entregar o segredo

    A IA apresenta a string bruta do token no chat para você copiar.

    create_token

Teste

Copie estes exemplos para começar.

Use estes prompts para iniciar o processo de criação de tokens.

Pontos de partida

Altere os nomes dos repositórios e os níveis de permissão para atender às suas necessidades reais.

Forgejo Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_OGbMMQVsinb0BjKH6qJI5Qwlr4pWGYjZRMU7QWs7/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Forgejo capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "forgejo-gitea-fork-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OGbMMQVsinb0BjKH6qJI5Qwlr4pWGYjZRMU7QWs7/mcp"
    }
  }
}
Copie no chat04

  • Crie um token de apenas leitura para o meu repositório 'web-app'.

  • Preciso de um novo token com acesso de escrita para o repo 'backend-api'.

  • Gere um token com escopo para 'data-science-project' que permita apenas acesso aos metadados do repo.

  • Crie um token para o repo 'frontend-assets' com permissões totais de repositório.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Forgejo uma vez e depois é só pedir.

Clique no link para vincular sua instância do Forgejo. Suas credenciais ficam criptografadas e privadas, permitindo que você converse com seus repositórios imediatamente.

Conectar Forgejo à sua IA

FAQ

Como esta tarefa funciona

  • 01

    A IA pode excluir meus tokens existentes?

    Não. Este MCP possui apenas a capacidade de criar novos tokens via ferramenta create_token.

  • 02

    A IA vai lembrar do meu token na próxima vez?

    Não. Por segurança, a IA não armazena seus tokens. Você deve copiar e salvar o token assim que ele for gerado.

  • 03

    Posso pedir permissões de nível administrador?

    Sim, desde que sua conta no Forgejo tenha autoridade para conceder essas permissões.

  • 04

    A IA escolhe os escopos por mim?

    A IA sugere escopos com base no que você escreveu, mas só executa a criação quando o comando condiz com sua intenção.

  • 05

    A IA pode criar tokens para outros usuários?

    Não. A IA só pode criar tokens usando as permissões do usuário que conectou o MCP do Forgejo.

  • Mais dúvidas sobre o Forgejo? A página do Connector responde. Veja tudo o que o MCP do Forgejo pode fazer

Conecte Forgejo ao Claude, Cursor, ChatGPT e outros