Projektraumの使い方

カスタム接続にサーバーアドレスを設定して「No sign-in」を選びます。Request headersで組み込みのx-api-keyを選択し、完全なprk_キーのみ入力します。OAuthクライアントIDは作りません。

URL: https://projektraum.io/api/mcp
x-api-key: prk_…

適切なヘッダーが設定できないアカウントではClaude Codeを使います。保存済みヘッダーを編集できない場合は正しい設定で接続を作り直します。

~/.codex/config.tomlに設定を追加します。PROJEKTRAUM_API_KEYにはキーだけを設定し、実行中のCodexプロセスに渡す必要があります。

[mcp_servers.projektraum]
url = "https://projektraum.io/api/mcp"
bearer_token_env_var = "PROJEKTRAUM_API_KEY"

BearerはCodexが付加します。ターミナルの変数は別途起動したデスクトップアプリに自動では渡りません。/mcpまたは接続表示で確認します。

作業プロジェクトの.mcp.jsonに設定を追加し、Claude Codeを起動する環境にPROJEKTRAUM_API_KEYを設定します。

{
  "mcpServers": {
    "projektraum": {
      "type": "http",
      "url": "https://projektraum.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PROJEKTRAUM_API_KEY}"
      }
    }
  }
}

既存のmcpServersを残してください。Claude Codeは起動時に変数を展開します。プロジェクト設定を承認し、/mcpで確認・再接続します。

現在のProjektraum接続はChatGPT Webからの保護された直接接続に対応していません。ChatGPTはOAuthを必要としますが、この接続はAPIキーを使用します。

prk_キーはOAuthクライアントIDやシークレットではありません。「No authentication」でも認証は回避できません。既存接続にはCodexを利用できます。