mcpField
P
pachca-profile

pachca-profile

github.com/pachca生産性1188 回インストール今日更新
リポジトリ

pachca-profile について

pachca-profileは、Pachca CLIでユーザープロフィールを取得・更新するスキルです。プロフィール情報、カスタムプロパティ、ステータス、アバターを扱います。

主な機能

  1. 01プロフィール情報の取得
  2. 02トークンのスコープと有効期限の確認
  3. 03ユーザーステータスの設定と削除
  4. 04カスタムプロフィール項目の一覧表示
  5. 05プロフィールアバターの追加と削除

活用シーン

  1. 01トークンのスコープを確認
  2. 02期限付きの不在ステータスを設定
  3. 03社員のカスタム項目を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pachca/openapi --skill pachca-profile

インストール後、Claude Code で/pachca-profileを入力して読み込まれたか確認します。

詳細

pachca-profile

クイックスタート

ユーザーに Pachca トークンを求めます（ボットの場合：Integrations → Bots にあるボットの API タブ、ユーザーの場合：Integrations → API）。

--token フラグを付けて、npx -y @pachca/cli 経由でコマンドを実行します。

npx -y @pachca/cli <command> --token $PACHCA_TOKEN

または、PACHCA_TOKEN 環境変数を設定します。

export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>

ヘルプ：npx -y @pachca/cli --help | ワークフロー：npx -y @pachca/cli guide

正常に使用できたら、CLI をグローバルにインストールするよう提案します：npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

はじめる前に

  1. 保存済みのプロフィールがある場合は、確認します。

    npx -y @pachca/cli auth status

    問題がなければ、--token を付けずにコマンドを実行します。

  2. プロフィールが設定されていない場合は、トークンを求めて --token を使用します。

    npx -y @pachca/cli auth status --token $PACHCA_TOKEN

  3. パラメーターがわからない場合は、pachca <command> --help を実行します。

ワークフロー

自分のプロフィールを取得する
  1. 現在のユーザーの情報を取得します。 
    pachca profile get

id、first_name、last_name、nickname、email、phone_number、department、title、role、suspended、invite_status、list_tags、custom_properties、user_status、bot、sso、created_at、last_activity_at、time_zone、image_url を返します。

自分のトークンを確認する
  1. トークンの情報（スコープ、作成日、有効期間）を取得します。 
    pachca oauth token-info

診断に便利です。トークンで利用できるスコープと、有効期限を確認できます。

ステータスを設定する
  1. ステータスを設定します。 
    pachca profile update-status --emoji="🏖️" --title="В отпуске" --is-away --away-message="Я в отпуске до 10 марта" --expires-at="2025-03-10T23:59:59.000Z"

    is_away: true は「不在」モードです。expires_at は自動リセットの日時です（ISO-8601、UTC+0）。away_message は最大1024文字です。

ステータスをリセットする
  1. ステータスを削除します。 
    pachca profile delete-status --force
プロフィールのカスタムフィールドを取得する

  1. 社員の追加フィールドの一覧を取得します。

    pachca custom-properties list --entity-type=User

    絞り込むには entity_type=User を追加します。

  2. プロフィールを取得します。custom_properties にフィールドの値が含まれます。

    pachca profile get

カスタムフィールドは、ワークスペースの管理者が設定します。

プロフィール画像をアップロードする
  1. ファイルからプロフィール画像をアップロードします。 
    pachca profile update-avatar --file=<путь_к_файлу>

    画像ファイルは multipart/form-data 形式で渡します。

プロフィール画像を削除する
  1. プロフィール画像を削除します。 
    pachca profile delete-avatar --force

制限事項

  • レート制限：約50リクエスト/秒。429 が返された場合は、待ってから再試行します。
  • status.title：最大50文字
  • status.away_message：最大1024文字
  • ページネーション：カーソルベース（limit + cursor）

エンドポイント

MethodPathDescription
GET/custom_properties追加フィールドの一覧
GET/profile自分のプロフィール
PUT/profile/avatar自分のプロフィール画像をアップロード
DELETE/profile/avatar自分のプロフィール画像を削除
GET/profile/status自分のステータス
PUT/profile/status自分の新しいステータス
DELETE/profile/status自分のステータスを削除

タスクの進め方がわからない場合は、references/ から該当するファイルを読んでください。

コメント

Markdown 対応