認証設定

kintone MCP Serverでは、複数の認証方法を利用できます。環境変数を使用して、適切な認証方法を設定してください。

設定の優先順位:

• 認証方式: パスワード認証とAPIトークン認証を同時に指定した場合、パスワード認証が優先されます
• 設定値: コマンドライン引数と環境変数を同時に指定した場合、コマンドライン引数が優先されます

認証方法

1. パスワード認証

kintoneのログイン情報を使用して認証を行います。

コマンドライン引数	環境変数	説明	必須
--username	KINTONE_USERNAME	kintoneのログインユーザー名	✓
--password	KINTONE_PASSWORD	kintoneのログインパスワード	✓

設定例:

環境変数:

export KINTONE_BASE_URL="https://example.cybozu.com"
export KINTONE_USERNAME="user@example.com"
export KINTONE_PASSWORD="your-password"

コマンドライン引数:

kintone-mcp-server \
  --base-url="https://example.cybozu.com" \
  --username="user@example.com" \
  --password="your-password"

2. APIトークン認証

アプリごとに発行されるAPIトークンを使用して認証を行います。

コマンドライン引数	環境変数	説明	必須
--api-token	KINTONE_API_TOKEN	APIトークン（カンマ区切りで最大9個まで指定可能）	✓

設定例:

環境変数:

export KINTONE_BASE_URL="https://example.cybozu.com"
export KINTONE_API_TOKEN="token1,token2,token3"

コマンドライン引数:

kintone-mcp-server \
  --base-url="https://example.cybozu.com" \
  --api-token="token1,token2,token3"

注意事項:

• APIトークンは英数字のみで構成される必要があります
• 複数のAPIトークンを使用する場合は、カンマで区切って指定します
• 最大9個までのトークンを指定できます

3. Basic認証（追加認証）

kintone環境でBasic認証が設定されている場合に使用します。上記の認証方法と併用して設定する必要があります。

コマンドライン引数	環境変数	説明	必須
--basic-auth-username	KINTONE_BASIC_AUTH_USERNAME	Basic認証のユーザー名	Basic認証使用時
--basic-auth-password	KINTONE_BASIC_AUTH_PASSWORD	Basic認証のパスワード	Basic認証使用時

設定例:

環境変数:

# APIトークン認証 + Basic認証
export KINTONE_BASE_URL="https://example.cybozu.com"
export KINTONE_API_TOKEN="your-api-token"
export KINTONE_BASIC_AUTH_USERNAME="basic-user"
export KINTONE_BASIC_AUTH_PASSWORD="basic-password"

コマンドライン引数:

kintone-mcp-server \
  --base-url="https://example.cybozu.com" \
  --api-token="your-api-token" \
  --basic-auth-username="basic-user" \
  --basic-auth-password="basic-password"

4. クライアント証明書認証

PFX形式のクライアント証明書を使用した認証を行います。クライアント証明書認証を使用する場合は、セキュアアクセス用のURLを使用する必要があります。

コマンドライン引数	環境変数	説明	必須
--pfx-file-path	KINTONE_PFX_FILE_PATH	PFXファイルのパス	証明書認証使用時
--pfx-file-password	KINTONE_PFX_FILE_PASSWORD	PFXファイルのパスワード	証明書認証使用時

設定例:

環境変数:

# APIトークン認証 + クライアント証明書
# 注意: クライアント証明書認証の場合は .s.cybozu.com ドメインを使用
export KINTONE_BASE_URL="https://example.s.cybozu.com"
export KINTONE_API_TOKEN="your-api-token"
export KINTONE_PFX_FILE_PATH="/path/to/certificate.pfx"
export KINTONE_PFX_FILE_PASSWORD="certificate-password"

コマンドライン引数:

kintone-mcp-server \
  --base-url="https://example.s.cybozu.com" \
  --api-token="your-api-token" \
  --pfx-file-path="/path/to/certificate.pfx" \
  --pfx-file-password="certificate-password"

注意事項:

• クライアント証明書認証を使用する場合、URLのドメインは .s.cybozu.com となります（例: https://example.s.cybozu.com）
• 通常のドメイン .cybozu.com ではクライアント証明書認証は使用できません

ネットワーク設定

プロキシ設定

企業環境などでプロキシサーバーを経由する必要がある場合に使用します。

コマンドライン引数	環境変数	説明	必須
--proxy	HTTPS_PROXY	プロキシサーバーのURL	-

設定例:

環境変数:

export HTTPS_PROXY="http://proxy.example.com:8080"

# 認証が必要な場合
export HTTPS_PROXY="http://username:password@proxy.example.com:8080"

コマンドライン引数:

kintone-mcp-server \
  --base-url="https://example.cybozu.com" \
  --api-token="your-api-token" \
  --proxy="http://proxy.example.com:8080"

トラブルシューティング

よくあるエラー

エラー: "Either KINTONE_USERNAME/KINTONE_PASSWORD or KINTONE_API_TOKEN must be provided"

• 原因：認証情報が設定されていない
• 解決策：ユーザー名・パスワードまたはAPIトークンのいずれかを設定する

エラー: "Both KINTONE_PFX_FILE_PATH and KINTONE_PFX_FILE_PASSWORD must be provided together"

• 原因：クライアント証明書のパスとパスワードの片方のみが設定されている
• 解決策：両方の環境変数を設定するか、両方とも削除する

エラー: "API tokens must be comma-separated alphanumeric strings (max 9 tokens)"

• 原因：APIトークンの形式が不正
• 解決策：英数字のみで構成されたトークンを使用し、9個以下に制限する

関連ドキュメント

• kintone APIトークンの発行方法