Overview

GitHub MCP provides a secure and structured integration between your application and GitHub. This allows your AI-based applications to use GitHub data (commit list, user searches, repository information, etc.) via MCP.

Configuring Settings via Config Manager

A configuration setting can only be used in a single project. If you want to use it in other projects, you must recreate the same settings.

1. Log in to the Kuika platform.
2. Open the project you want to work on from the Apps screen.
3. Click the Config Manager module in the top menu.

4. To edit an existing configuration, click its name in the list, or create a new configuration using the Create a blank configuration card.
5. Make sure the App Settings tab is selected at the top of the configuration screen.
6. In the left menu, click the MCP option under the INTEGRATIONS heading.
7. Click the Add New link under the GitHub section.

8. In the GitHub Settings window that opens, fill in the following fields (all fields are required):

• Name: A unique name for this integration.
• Access Token: The Personal Access Token (PAT) you created on GitHub. You can create the token in GitHub under Settings > Developer settings > Personal access tokens. Be sure to grant the token sufficient permissions for the repositories your application needs to access.

9. Click the Create button.
10. Select the configuration you created from the GitHub dropdown menu.
11. Click the Save button in the upper-right corner to save your changes. (In an existing configuration, this button appears as Update.)

Creating a GitHub Access Token

1. Log in to your GitHub account (https://github.com).

2. From the top right, follow the path Settings → Developer Settings → Personal Access Tokens → Tokens (classic).

3. Click Generate new token → Generate new token (classic).

4. Fill in the required fields:
   
   • Note: Enter a description for the token (e.g., MCP Server Access).
   • Expiration: Select a duration (30 days, 90 days, or No expiration).
   • Scopes (permissions):
     
     • repo → Access to repositories
     • read:org → Organization information
     • workflow → Workflows
     • admin:repo_hook → Webhook management

5. Click the Generate token button.

6. The token is only displayed once → Copy it with Copy and paste it into the GitHub Settings field in Kuika.

Action Types

GitHub Commit List

‍

Retrieves the commit list for a specific repository.

Action Input

• settings: GitHub setting you defined in Config Manager.
• author: The person who made the commit.
• owner: Repository owner / organization name.
• repo: Repository name.
• sha: The unique identifier of the commit (SHA-1 hash).
• page: The page number to retrieve.
• perPage: Number of items per page.

Action Output

The commit search results return the following fields:

• author → Information about the user who made the commit (login, id, avatar, url, etc.)
• committer → Information about the user who sent the commit to the repository (may be different from the author)
• commit → Commit details (author, committer, message, date, tree, verification)
• sha → Unique identifier of the commit
• html_url → GitHub web link of the commit
• comments_url → Commit comment link

• url → Commit details via API
• node_id → GitHub GraphQL internal ID
• parents → List of parent commits (may be multiple for merge commits)

Important Subfields:

• commit.message → Commit message
• commit.author → Name, email, date
• commit.committer → Sender information (name, email, date)
• verification.verified → Is the commit signed?
• verification.reason → Reason for verification result
• verification.signature → Signature information (PGP/GPG)

GitHub Search Users

Searches for users on GitHub.

Action Input

• settings: GitHub settings.
• query: Search term (e.g., “john smith”, “location:seattle”, “followers:>100”).
• page: Which page to retrieve.
• perPage: Number of results per page.

Action Output

‍

• total_count: Total number of users in the search results.
• incomplete_results: Boolean → Was the search completed?
• items: List of users.
  
  • login → Username
  • id → User ID
  • avatar_url → Profile picture URL
  • html_url (or profile_url) → GitHub profile link
  • type → User type (User / Organization)

Usage in Kuika

GitHub settings created in Configuration Manager can be used by linking them to the settings parameter in the GitHub Action in the project.

For example:

• It is possible to list the commit history of the “kuika/platform-core” repository
• and search for users according to the “location:turkey followers:>50” criteria.