Files
cursor__plugins/third_party/github/README.md
Sam Sokolin 1f4e9b5976 Add Playwright and GitHub third-party MCP plugins (#193)
* Add Playwright and GitHub third-party MCP plugins

Wire Microsoft's local Playwright MCP (npx stdio) and GitHub's remote
MCP server (PAT auth) into the marketplace, matching existing third_party
plugin layout and manifests.

Co-authored-by: Sam Sokolin <SamSokolin@users.noreply.github.com>

* Pass -y to npx for Playwright MCP

Avoid first-launch hangs when npx would otherwise prompt for
install confirmation over non-interactive MCP stdio.

Co-authored-by: Sam Sokolin <SamSokolin@users.noreply.github.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Sam Sokolin <SamSokolin@users.noreply.github.com>
2026-08-06 19:18:35 -04:00

65 lines
2.2 KiB
Markdown

# GitHub
Cursor plugin that connects agents to [GitHub](https://github.com) through GitHub's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
Work with repositories, issues, pull requests, code search, and Actions under the permissions of a personal access token you provide.
## Install
1. Open **Cursor Settings → Plugins**.
2. Search for **GitHub**.
3. Click **Install**, then set your GitHub personal access token (below).
Or run `/add-plugin github` in chat.
## MCP
```json
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}"
}
}
}
}
```
## Setup
GitHub's remote MCP server authenticates with a **personal access token (PAT)**. Create one, then paste it into the plugin config.
### 1. Create a personal access token
1. Open https://github.com/settings/tokens.
2. Create either a **fine-grained** token or a **classic** token.
3. Grant only the scopes the agent needs. Typical choices:
- **Repositories / contents** — read or write code and files
- **Issues** — list, create, and update issues
- **Pull requests** — list, review, and manage PRs
- **Actions** — inspect workflow runs (if you want CI access)
- **Metadata** — always required on fine-grained tokens
4. Set an expiration you are comfortable with, then generate and copy the token.
Prefer a fine-grained token scoped to specific repositories when that is enough. Classic tokens with `repo` are broader and should be treated carefully.
### 2. Configure the plugin
In **Dashboard → Plugins → Configure**, set **GitHub personal access token** to the value you just created.
Tool calls run with that token's permissions. Rotate or revoke the token from GitHub Settings if it is ever exposed.
## Docs
- Use the GitHub MCP server: https://docs.github.com/en/copilot/how-tos/context/use-mcp/use-the-github-mcp-server
- Managing personal access tokens: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
Logo is GitHub's official Octocat mark, placed on a white tile with padding so it reads well in the Cursor UI.
## License
MIT