Guides / API tokens
How to create a Sentry API token with the narrowest permissions
Shipyard uses a Sentry token for error tracking. The token is stored in your computer's keychain and is not sent to shipyardmcp.com. These are the exact steps, and the smallest set of permissions that works.
Create the token
Start here: https://sentry.io/settings/account/api/auth-tokens/
- Open the link, Create New Token.
- Tick the scopes listed here.
- Paste the token and your organisation slug into Shipyard.
Permissions, and why each one is needed
- project:read, project:write: Create the project and read its DSN.
- project:admin: Delete the project on destroy. Leave out to keep projects.
- team:read, org:read: Find the team the project goes in.
What stays manual
These are things only a person can do at this provider. Shipyard cannot and will not do them for you.
- Creating the Sentry account.
What you paste into Shipyard
- Auth token
- Organisation slug
- Team slug (empty for the first team) (optional)
- Base URL (empty for https://sentry.io; EU: https://de.sentry.io) (optional)
Have this set up for you
Shipyard connects your accounts once and then does all of this for every new product, in about an hour.
See how it works