meinKontextDocs
Navigation & search

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.

A dedicated agent profile's MCP bearer, stored as a GitHub Agents secret. Repository-configured cloud agents do not support remote MCP OAuth.

  1. Under Agents, create a profile with only the required read access. Select Manage connection, choose a lifetime and Issue new credential. An organization API key is not inherently read-only. Agent setup.
  2. As repository administrator, store Bearer followed by the issued credential as the Agents secret COPILOT_MCP_MEINKONTEXT_AUTHORIZATION. The complete value belongs only in the secret store.
  3. Under repository Settings → Copilot → MCP servers, merge the JSON below with existing configuration and save. Older interfaces may place this under Coding agent. Keep only tools exposed to this profile and needed for your task.
  4. Start a fresh cloud-agent task asking it to list available meinKontext objects without changing anything. Inspect its list_objects call and result. Update the secret when the credential expires; revoke the credential in meinKontext when access ends.
json
{
  "mcpServers": {
    "meinkontext": {
      "type": "http",
      "url": "https://meinkontext.de/mcp",
      "headers": {
        "Authorization": "$COPILOT_MCP_MEINKONTEXT_AUTHORIZATION"
      },
      "tools": ["list_objects", "get_object", "use_skill", "recall", "search"]
    }
  }
}
  • The cloud agent can invoke enabled tools without per-call approval. Its repository MCP configuration supports tools, not resources or prompts. The allowlist does not grant server-side rights. GitHub configuration guide.
  • On HTTP 401, check credential expiry, environment, secret name and the Bearer prefix. On HTTP 403 or missing tools, check the profile's grants. Never include authorization headers in logs.
  • For interactive browser login, use VS Code or Copilot CLI.
  • Researched on 31 October 2026 from official documentation; a real Copilot cloud-agent tool call against meinKontext has not yet been verified. This setup does not establish proactive skill or memory adoption.