---
title: "Limit a grant"
url: https://docs.corefinity.com/mcp/limit-a-grant
type: page
last_updated: 2026-11-13
feature: mcp
---
# Limit a grant

Pin a token or app to clusters, sites or environments, restrict its IP addresses and set its expiry.

Scopes say what a grant may do. These three limits say where, from which addresses and for how long.

| Limit         | In the dialog      | Default                         |
| ------------- | ------------------ | ------------------------------- |
| Pins          | **Where it works** | Everything in your organisation |
| IP allow-list | **IP addresses**   | Any address                     |
| Expiry        | **Expires**        | **90 days**                     |

Set them when you create a token or approve an app, and change them later with **Edit restrictions…** in the grant's **…** menu. [MCP and API access](/guides/organisation/developers/mcp-and-api-access) has the steps, and [Sign in and tokens](/mcp/sign-in-and-tokens) says who can change a grant.

## Pins

Choose **Only what I choose**, then tick clusters, sites or environments. A pinned grant reaches only what at least one pin covers.

| Pin         | Covers                                                                        |
| ----------- | ----------------------------------------------------------------------------- |
| Cluster     | The cluster and every site and environment in it, including ones added later. |
| Site        | The site and all its environments, including ones added later.                |
| Environment | That environment only.                                                        |

> **Tip:** To keep commands off production, pin only a staging environment.

A pinned grant:

- cannot create a cluster or a standalone CoreStack site;
- can add a site to a cluster only when that cluster is pinned;
- can change a whole cluster (package, capacity, delete) only with the cluster's pin, or a site pin on every site in it;
- can delete a site only with a site or cluster pin, never an environment pin;
- cannot change organisation-wide settings, such as the Cloudflare connection or Marketplace keys;
- can still read your organisation's details, with lists narrowed to its pins.

A grant holds up to 500 pins. A pin whose target is deleted never widens the grant.

A call outside the pins answers `pin_refused` with a link that opens **Edit restrictions** with the missing site or cluster already added. For a create or an organisation-wide change, the link offers everything in your organisation instead.

## IP allow-list

Add up to 100 IPv4 or IPv6 addresses or CIDR ranges, for example `198.51.100.0/24`. Requests from any other address are refused.

> **Warning:** Cloud apps such as claude.ai and ChatGPT connect from their own servers, so an office list blocks them.

## Expiry

Choose **7 days**, **30 days**, **90 days**, **365 days**, **On a date…** or **Never**. [Revoke access](/mcp/revoke-access) says what stops when a grant ends.
