チームとプロジェクト

チーム

チームは、プラン・残高・メンバーを共有する単位です。サイドバー上部のチーム名から切り替えます。設定はプロジェクト設定とチーム設定に分かれ、選択中のプロジェクトには「プロジェクト詳細」「メンバーと権限」、チームには「チーム詳細」「メンバー」「料金・請求」があります。チーム設定のメンバー ↗ではチームの所属を、メンバーと権限 ↗では選択中のプロジェクトの所属を管理します。

チームのロールは管理者・編集者・閲覧者です。オーナーは「オーナー」と表示され、管理者の権限をすべて持ちます。管理者は請求と支出上限を管理し、全プロジェクトの管理者として自動参加します。編集者はチーム設定とメンバーを編集できますが、請求の変更と、管理者ロールの付与・変更はできません。閲覧者は割り当てられたプロジェクトだけを使います。プロジェクトの管理者というだけでは、請求は操作できません。

まずプロジェクトを選ぶ

オンボーディングでチーム名を決めると、最初のプロジェクトを自動作成し、「デフォルト」と表示します。チーム名の下にあるプロジェクト選択欄から、検索・選択・作成します。アクセスできるプロジェクトを常に一つ選び、チームごとに前回の選択を引き継ぎます。

カスタムツール・スキル・エージェント・ルール・フック・フォルダー・シークレット・接続・APIキーは、そのプロジェクトで管理します。エンジニアリングとマーケティング、またはアクセス範囲の異なるアプリケーションごとに分けられます。「はじめに」も選択中のプロジェクト内で開始します。

プロジェクトの所属と管理

チームのロールと、プロジェクトごとのロールは別です。プロジェクトの所属者は同じツール・スキル・ルール・接続を使えます。プロジェクトには管理者か利用者として所属します。利用者は設定済みのものを使い、自分のAPIキーも作成できますが、リソースは以前自分が作ったものも含めて編集できません。リソースを編集するのはプロジェクト管理者です。管理者はメンバーと権限 ↗で所属を、プロジェクト詳細 ↗で設定を管理します。

プロジェクト詳細の「ツールの実行」で、プロジェクト内で使えるツールを決めます。管理者本人と既存のキーにも適用されます。プロジェクトに追加した接続と、そこで外した操作は全員に共通です。最後の有効なプロジェクト管理者は削除・降格できません。人によって使うリソースを分けたい場合は、別のプロジェクトを使います。

APIキーのスコープと認証情報ごとの追加制限は、CLI・MCP・APIでも適用されます。実行可能なフック・MCP設定・権限ファイルの変更は、プロジェクト管理者がアプリで行い、APIキーからは変更できません。

メンバーを招待する

チーム設定のメンバー ↗から招待するときは、チームのロールを選びます。編集者・閲覧者には所属プロジェクトにチェックを入れ、それぞれ管理者か利用者を選びます。同じ人でも、エンジニアリングでは管理者、マーケティングでは利用者にできます。チェックしなかったプロジェクトや、後から作ったプロジェクトには自動で追加されません。チーム管理者は、既存・新規の全プロジェクトへ自動で管理者として参加します。プロジェクト管理者はメンバーと権限 ↗から、選択中のプロジェクトへ招待することもできます。その場合、招待された人はチームに閲覧者として参加します。

連携ごとに、そのプロジェクト専用の認証情報を使います。アプリでプロジェクトを切り替えても、既存のAPIキーや接続が別のプロジェクトへ移ることはありません。

CLI・MCPでプロジェクトを切り替える

CLIでは、プロジェクトごとに一度ブラウザーで承認し、承認済みのプロジェクトの間で切り替えます。

npx --yes @relvo/cli project list
npx --yes @relvo/cli project add
npx --yes @relvo/cli project use PROJECT_ID
npx --yes @relvo/cli tools --query search --project PROJECT_ID
npx --yes @relvo/cli team-skills sync --project PROJECT_ID

project addは新しい承認画面を開き、そこで接続先のプロジェクトを選びます。project useは現在のアクセスを確認して既定値を変更し、ツールコマンドの--projectはそのコマンドだけの指定です。team-skills syncは選択したプロジェクトの管理対象ファイルを取り込みます。切り替えると、前のプロジェクトで編集したファイルは~/.config/relvo/project-archives/へ退避し、出力に保存先を表示します。実行可能なファイルには引き続き--allow-scriptsが必要です。すべてのオプションはnpx --yes @relvo/cli help projectで確認できます。

セットアップで登録したローカルMCPはplatform_projectsとplatform_project_selectを提供します。プロジェクトを選んだらRelvo MCPを再接続し、そのプロジェクトのツールと権限を読み込みます。再接続するまで、古い接続はAPIリクエストを止めます。受付済みの処理は元のプロジェクトに残ります。ChatGPT・ClaudeからURLで接続している場合は、ホストで接続をやり直し、承認画面でプロジェクトを選びます。既存のキーや承認の所属先は変わりません。

プロジェクト数と既存チーム

1チームあたり、Freeは3個、Hobbyは5個、Proは30個です。プランと残高はチーム全体で共有します。すでに上限を超えているチームはプロジェクトをそのまま使え、新しいプロジェクトの作成だけができません。スキル・ルールなどは1プロジェクトに、Freeは10件、Hobbyは50件、Proは100件まで作れます。上限を超えたプロジェクトも既存のものは編集・削除でき、追加だけができません。

プロジェクト導入前からあるチームは元のプロジェクトを引き継ぎ、その設定・メンバー・キー・接続もそのまま使えます。同じオーナーのチーム同士もまとめません。接続済みのMCP、保存済みのOAuth承認、以前のCLIのログインも、再接続なしで同じプロジェクトを使います。

プロジェクトを削除する

プロジェクト管理者は、プロジェクト詳細 ↗の末尾でプロジェクト名を入力して削除します。チームには最低一つのプロジェクトが必要です。外部アプリに登録したトリガーが残っていると削除できないため、先に削除してください。削除すると、そのプロジェクトのメンバー・APIキー・MCPの承認・接続・定期実行が止まります。利用状況と請求の記録は残ります。

有効な管理者がいないプロジェクトは、チームのオーナーがチーム詳細 ↗の「管理者がいないプロジェクト」から自分を管理者にできます。失効したキーは戻らないため、新しく作成してください。