kognitaAnthropic provider
Add an Anthropic API key so the project's agent environment can answer chats. The key is encrypted after saving, never shown again, and can be replaced whenever you rotate it.
What this enables
- Run project-aware chat backed by your repositories and configured MCP tools
- Keep provider billing under your own Anthropic account
- Rotate or remove the provider key from the project whenever access needs to change
Before you start
You need an Anthropic account with API access and a Kognita project where you have admin permissions. If the project does not have a repository yet, add one before or after saving the key. Either order works.
Setup guide
Open the Anthropic Console
Sign in to the Anthropic Console and open the API keys area for the workspace you want Kognita usage billed against.
Create a new API key
Create a new key with a label you will recognize later, such as Kognita or the name of the project. Copy the key before closing the dialog.
Set a max spend limit
We recommend setting a max spend limit for the key in Anthropic. This gives you a clear ceiling for usage and makes it easier to understand how much the project is spending.
Save the key in Kognita
Go to your Kognita dashboard, open the project, and click API Keys. Paste the Anthropic key and click Save.
After saving, the full key is never visible again. Kognita only shows a masked value so you can confirm that a key exists without exposing the secret.
Start chatting
Kognita provisions the agent environment automatically when the project is created, so the chat panel is usable as soon as the key is saved. If the environment never started, use Provision agent environment in the project chat panel.
Security note
Anthropic API keys are encrypted before saving. The dashboard never displays the full key after it has been added. To rotate access, paste a new key in the API Keys page and replace the existing one.
Troubleshooting
I saved the key but provisioning did not start
Provisioning starts when the project is created, not when the key is saved. If the chat panel still shows the setup checklist, click Provision agent environment there; if setup failed, the error is shown under the button.
Can I view the key after saving it?
No. For safety, Kognita never shows the full key again after saving. If you lose the original key, create a new one in Anthropic and replace it in Kognita.
How do I control usage?
Set a max spend limit for the key in Anthropic. That gives you a predictable cap for the project and makes billing easier to reason about.
How do I rotate the key?
Create a new Anthropic API key, open API Keys in the Kognita project, paste the new key, and click Replace.