---
title: Credentials and connections
description: How API keys and accounts are stored, and how the AI and gems use them without ever seeing the plaintext.
section: guide
order: 60
updated: 2026-11-12
translation_of: zh
source_sha: 120411938214
---
# Credentials and connections
Credentials are the secrets you hand to Notochord to look after: API keys for model providers, tokens for external services, and mailbox logins. They all live under "Settings › Accounts", and each account is one connection.
## How they are stored
- Credentials are stored encrypted on this computer. Nothing is uploaded to any cloud server.
- The encryption key lives in the system keychain (or in the organization's folder, if you chose "No encryption" during first-run setup). See [Quickstart](/en/guide/quickstart.md) and [Organizations](/en/guide/organizations.md).
- Each [organization](/en/guide/organizations.md) has its own set of credentials, kept separate from the others.
## How the AI and gems use them
**Neither of them ever sees the secret itself.** When the AI or a gem wants to call an external service, all it receives is permission to "make a request through this connection". Notochord sends the request, and adds the secret only at the moment it goes out. As a result:
- Secrets never appear in the AI's conversation or in tool-call records.
- Even if a gem's code is faulty, it cannot get the secret; it can only make requests through connections that were granted to it.
- A connection can only reach the sites it was registered for, so the secret cannot be carried elsewhere.
## Who gets access
By default, nobody. A gem can use an account only after you select it on the gem's page; gems working in a project can use an account only if you tick it in the project's settings. Requests through an account that has not been granted are refused. See [Gems: installing and using them](/en/guide/gems.md) and [Organizing work with projects](/en/guide/projects.md).
## Deleting
Delete an account under "Settings › Accounts" and the stored secret is deleted with it. Gems that relied on it stop working until you give them another account.