• SECURITY
  • STRUCTURE
  • ACCESS
  • HUMAN

How to audit repository and branch settings with your AI

Connect Gitea to your agent to run security and structure checks across your instance.

Ask AI about this page

Short answer

Can I audit my Gitea settings with AI?

Yes. You can ask your agent to pull repository details, list branches, or inspect organization structures. You'll get a clear view of your visibility and protection rules.

Audit outcomes.

Where your findings land.

Your agent pulls the data and organizes it into these categories.

SECURITY

Protection rule checks

The AI checks if branches have the right restrictions. You'll see which repos are vulnerable to unreviewed pushes.

STRUCTURE

Org hierarchy maps

Get a clear view of how your organizations are set up. The agent identifies how repos are grouped.

ACCESS

Visibility audits

Verify which repositories are public or private. This helps you catch accidental exposure immediately.

HUMAN

Manual fixes needed

The AI identifies gaps in your settings. You'll need to go into the Gitea UI to actually change the rules.

The workflow

What your AI does when the audit request arrives.

Your agent acts as a bridge between your chat interface and your Gitea instance.

  1. Fetch repo data

    The agent pulls specific metadata for a repository to check its visibility and settings.

    get_repo

  2. Scan branches

    It looks through all existing branches to see what's active and how they are configured.

    list_branches

  3. Map organizations

    The agent pulls organization-level data to understand the broader structure.

    get_org

  4. Report findings

    The agent compares the data it found against your specific security questions and summarizes the gaps.

    get_repoget_org

Try it

Copy these to start.

Use these prompts to begin your audit.

Starting points

Swap out the repo or org names for your actual Gitea identifiers.

Gitea Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  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 — Gitea capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "gitea-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp"
    }
  }
}
Copy into chat04

  • Check the visibility settings for the 'frontend-app' repository.

  • List all branches in the 'core-api' repo and tell me if any look unprotected.

  • Show me the structure and members for the 'dev-ops' organization.

  • Are there any private repositories in the 'marketing' org that shouldn't be?

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

Start here

Connect Gitea once, then ask.

Just link your Gitea instance. Your credentials stay encrypted, and you can immediately start asking questions about your code hosting setup.

Connect Gitea to your AI

FAQ

How the audit behaves

  • 01

    Can the AI change my branch protection rules?

    No. The AI can only read and report on your current settings. You must make any changes manually in Gitea.

  • 02

    Can the AI delete a repository?

    No. The tools provided are read-only. Your data and repositories remain safe from accidental AI deletion.

  • 03

    Does the AI see my actual code?

    No. The agent only accesses repository metadata, branch lists, and organization details.

  • 04

    Can I audit all organizations at once?

    You can ask the agent to check specific organizations one by one using the organization tools.

  • 05

    How does the AI know which branches are protected?

    It uses the branch listing and repository data to inspect the configuration of each branch.

  • More questions about Gitea? The Connector page answers them. See everything the Gitea Connector can do

Connect Gitea to Claude, Cursor, ChatGPT & more