Skip to main content

GitHub MCP Integration

Connect GitHub's Model Context Protocol (MCP) server to Oodle to enable the AI Assistant to search and analyze your codebase. This integration allows Oodle to recommend code fixes when alerts are triggered, helping you resolve issues faster by understanding your code context.

What is GitHub MCP?​

GitHub provides an MCP server that exposes code search and repository access capabilities. When connected to Oodle, the AI Assistant can:

  • Recommend code fixes when alerts fire
  • Search code across your repositories
  • Read file contents for context
  • Understand your codebase structure
  • Provide code-aware debugging suggestions

Prerequisites​

  • A GitHub account
  • A GitHub Personal Access Token (PAT) with repository access
  • An active Oodle instance

Configuration​

Step 1: Generate a GitHub Personal Access Token​

  1. Go to GitHub Personal Access Tokens
  2. Click Generate new token
  3. Select Fine-grained tokens (recommended) or Classic tokens
  4. Configure the token:
    • Name: Give it a descriptive name (e.g., "Oodle MCP Integration")
    • Expiration: Choose an appropriate expiration period
    • Repository access: Select the repositories you want the AI to access
    • Permissions: Grant Contents read access for code search
  5. Click Generate token
  6. Copy the token immediately (you won't be able to see it again)
warning

Keep your Personal Access Token secure. Never share it or commit it to version control.

Step 2: Configure in Oodle​

  1. Log in to your Oodle instance
  2. Navigate to Settings → Integrations
  3. Find the GitHub MCP integration card under the MCP section
  4. Click to open the configuration drawer
  5. Enter your GitHub Personal Access Token
  6. Wait for validation (a green checkmark indicates success)
  7. Select the repositories you want the AI to access
  8. Click Save
tip

The repository dropdown automatically loads repositories accessible with your PAT. You can also manually type repository names in owner/repo format if needed.

How It Works​

Once configured, Oodle's AI Assistant can access your codebase when helping you debug issues and automatically suggest code fixes for alerts. For example:

  • Alert-triggered code fixes: When an alert fires, Oodle can analyze the relevant code and suggest specific fixes to resolve the issue
  • Error investigation: The AI can search your code for relevant functions, error handlers, and configuration that may be causing issues
  • Context-aware suggestions: By understanding your codebase structure, the AI provides more accurate and actionable fix recommendations
  • Faster resolution: Instead of just identifying problems, Oodle can show you exactly what code to change

Repository Selection​

You can optionally specify which repositories the AI should focus on. This is useful when:

  • You want to limit AI access to specific projects
  • You're debugging issues in a particular service
  • You want faster responses by narrowing the search scope

If no repositories are selected, the AI can search across all repositories accessible with your PAT.

Security Considerations​

  • Token Storage: Your PAT is stored securely in Oodle's encrypted configuration
  • Access Scope: Only repositories you explicitly grant access to can be searched
  • Token Rotation: You can update or rotate your PAT at any time from the integration settings
  • Audit Trail: All AI interactions with your codebase are logged

For the GitHub MCP integration, we recommend:

PermissionAccess LevelPurpose
ContentsReadSearch and read code files
MetadataReadList repositories and branches

Avoid granting write permissions unless specifically needed.

Troubleshooting​

Token validation fails​

  • Verify the token hasn't expired
  • Check that the token has the required permissions
  • Ensure the token is correctly copied (no extra spaces)

Repositories not loading​

  • Confirm the PAT has access to the repositories
  • For organization repositories, ensure you've authorized the token for the org
  • Try refreshing the page and re-entering the token

AI can't find code​

  • Verify the correct repositories are selected
  • Check that the files exist in the default branch
  • Ensure the PAT has Contents read permission

Managing the Integration​

Update Token​

  1. Open the GitHub MCP integration settings
  2. Enter a new Personal Access Token
  3. Click Save

Change Repository Access​

  1. Open the GitHub MCP integration settings
  2. Add or remove repositories from the selection
  3. Click Update

Disable Integration​

  1. Open the GitHub MCP integration settings
  2. Toggle the Enabled switch off
  3. Click Update

Remove Integration​

  1. Open the GitHub MCP integration settings
  2. Click the Delete button
  3. Confirm the deletion

Support​

If you encounter issues with the GitHub MCP integration: