Getting started
Connect your app
Client-specific setup with steps and commands.
Client setup
Choose your app and follow its setup steps. The guide explains the available sign-in options and any limitations.
Personal OAuth (recommended): choose your account or an agent profile with selected access during authorization. Profile selection and setup.
- Add the server to
~/.kimi-code/mcp.jsonat user level, or to.kimi-code/mcp.jsonin the working directory at project level, as shown below. The HTTP MCP endpoint ishttps://meinkontext.de/mcp. - Start a new Kimi session. A server added by editing
mcp.jsondoes not register in an already-open session. - Run
/mcp-config login meinkontext, then authorize your meinKontext account or an agent profile in the browser. - Run
/mcpand check the connection status formeinkontext.
{
"mcpServers": {
"meinkontext": {
"url": "https://meinkontext.de/mcp"
}
}
}- The user-level file applies across projects and does not require workspace trust. The project-level file applies only to that repository and requires workspace trust. Review the remote URL in Kimi's trust prompt before trusting the folder. See the official Kimi Code MCP documentation.
- Keep the URL exactly
https://meinkontext.de/mcp. It is the canonical OAuth resource for which meinKontext issues access tokens. - Reconnect or start a new session after server-side tool or instruction changes. A running session can keep the old tool definitions and catalog digest.
- With a personal OAuth connection, ask: "Set up meinKontext for this project using
setup_client. Prefer relevant skills, memory and knowledge without repeated reminders." Name the connection as configured in your client. Agent profiles and org API keys cannot run personal setup. - The tool returns a recipe; your agent checks the effective instruction file and adds only its marked routing block. Existing rules remain. It does not copy your context or switch off native memory, but it tells your agent to save lasting facts only in meinKontext. On request it can supply a local hook and rollback recipe; your client must install and trust it. Supported local versions get a project or user recipe; unknown versions and browser/cloud clients get session instructions. Start a new session afterwards.
- Ask the agent to check with
action: "check"or remove withaction: "remove". A matching block hash confirms only the client-reported structure. Test a relevant task in a fresh session to see whether it actually reads the skill or memory. Keep the local installation receipt: it lets the agent remove its unchanged block even when the server is offline. Modified or duplicate blocks require reconciliation.
Optional: org API key instead of personal OAuth
- Mint an org API key with the
create_api_keytool from a connected session, and export it in your shell (for example asMEINKONTEXT_TOKEN). The environment variable must be present when Kimi starts. - Use the following server entry.
bearerTokenEnvVarmakes Kimi send the bearer token from the named environment variable.
{
"mcpServers": {
"meinkontext": {
"url": "https://meinkontext.de/mcp",
"bearerTokenEnvVar": "MEINKONTEXT_TOKEN"
}
}
}-
bearerTokenEnvVarcontains only the variable name, never a literal token. Keep the actual key out of configuration files and protect its environment or secret store. - Org-scoped service principal: read-only for objects (authoring tools are hidden), and for memory:
recallandsearchwork,rememberandforgetneed OAuth.