github / github/github-mcp-server

The doc should provide a minimum list of permissions for the GitHub Access Token

Aperta
#2,963 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
enhancement request ai review
Lingua principale
Go
Stelle
33k
Fork
5k
Merge medio
2g 1h
PR unite (30g)
52

Descrizione

### Describe the feature or problem you’d like to solve

A clear and concise description of what the feature or problem is.

- The doc should provide a minimum list of permissions for the GitHub Access Token.
- The current documentation at https://github.com/github/github-mcp-server/blob/v1.7.0/docs/installation-guides/README.md mentions this,

> All installations with Personal Access Tokens (PAT) require: GitHub Personal Access Token (PAT): Create one here
>
> Regardless of which installation method you choose, follow these security guidelines:
>
> Limit Token Scope: Only grant necessary permissions to your GitHub PAT

- However, the list of permissions for `personal access token (classic)` is too long. I think the documentation needs to provide a minimum list of required permissions. See https://github.com/settings/tokens/new .
- Image
- Furthermore, the URL provided in the documentation is for creating the `personal access token (classic)`. I think the documentation should guide users to use the `fine-grained personal access token`, which only allows access to repositories within a specific scope, while the `personal access token (classic)` allows access to all unrelated repositories.
- Image

### Proposed solution

How will it benefit GitHub MCP Server and its users?

- This would obviously reduce the cognitive load.

### Example prompts or workflows (for tools/toolsets only)

If it's a new tool or improvement, share 3–5 example prompts or workflows it would enable. Just enough detail to show the value. Clear, valuable use cases are more likely to get approved.

- Null.

### Additional context

Add any other context like screenshots or mockups are helpful, if applicable.

- Null.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Start with docs/installation-guides/README.md and review the linked GitHub token creation pages to verify which permissions the server documentation currently assumes. Update the guidance to identify the minimum required permissions and direct users to the appropriate token flow; done means the setup instructions are specific and the least-privilege recommendation is clear.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
github
Ambito
authentication, documentation, security
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Tranquilla
Chiarezza
Abbastanza chiara
Idoneità per principianti
57/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.