Guides / API tokens
How to create a OpenAI API token with the narrowest permissions
Shipyard uses a OpenAI token for ai provider. 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://platform.openai.com/api-keys
- Open the link, Create new secret key.
- If you restrict it, keep read access to Models so Shipyard can check the key.
- Paste it into Shipyard.
Permissions, and why each one is needed
- A project key, restricted to the endpoints your app uses if you like: Shipyard does not call OpenAI except to check the key. It writes this key into each project so your app can.
Set up once in OpenAI before your first launch
- Add credit. A key on an account without credit passes the check and then fails in your app. (https://platform.openai.com/settings/organization/billing)
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 OpenAI account and adding credit.
What you paste into Shipyard
- API key for your apps
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