giteamcp/create_gitea_token.md

How to Create a Gitea Token

Step-by-Step Guide

1. Log into your Gitea instance

• Go to your Gitea URL (e.g., http://157.66.191.31:3000)
• Log in with your username and password

2. Navigate to Settings

• Click on your profile picture in the top-right corner
• Select "Settings" from the dropdown menu

3. Go to Applications

• In the left sidebar, click on "Applications"
• Look for "Manage Access Tokens" or "Tokens"

4. Generate New Token

• Click "Generate new token"
• Fill in the form:
  • Token Name: Give it a descriptive name (e.g., "MCP Server")
  • Scopes: Select the following permissions:
    • ✅ repo (Full control of private repositories)
    • ✅ write:packages (Write packages)
    • ✅ read:packages (Read packages)

5. Copy the Token

• Click "Generate token"
• IMPORTANT: Copy the token immediately - you won't be able to see it again!
• The token will look like: 37c322628fa57b0ec7b481c8655ae2bebd486f6f

6. Use in MCP Server

• Paste the token in the "Gitea Token" field in the MCP Server interface
• The token is pre-filled with the example token for testing

Security Notes

• Never share your token - it provides access to your repositories
• Store tokens securely - don't commit them to version control
• Use different tokens for different applications
• Revoke tokens when no longer needed

Example Token (for testing)

37c322628fa57b0ec7b481c8655ae2bebd486f6f

This token is already pre-filled in the MCP Server interface for convenience.