setup

セットアップ — 前提条件と MCP の設定

CLI ツールをインストールし、GitHub/GitLab に認証して、OpenCode 用に mcp-atlassian Jira 統合を設定します。

前提条件

• apt パッケージマネージャーを使用する Linux
• bash と curl が利用可能
• インターネット接続（apt パッケージと uv インストーラー用）

起動条件

ユーザーが「セットアップ」「前提条件をインストール」「Jira を設定」などと言った場合。

重要 — 対話型スキルのみ。 このスキルではユーザーとのやり取り（認証プロンプト、Jira の認証情報）が必要です。自律型スキルのパイプライン（fast-meeting、issue-review など）からサブステップとして呼び出してはいけません。入力を待ったまま処理が停止し、入力が届くことはないためです。

---

ワークフロー

フェーズ 1 — CLI ツールのインストール

同梱のスクリプトを実行して、不足しているツールをインストールします（冪等性があり、インストール済みのツールはスキップします）。

bash "$(dirname "$0")/reference/setup.sh"

スクリプトは、未インストールの場合に以下をインストールします（apt を使用）。

• gh — GitHub CLI
• glab — GitLab CLI
• jq — JSON プロセッサー
• uvx — 公式の uv インストーラーを使用（curl -LsSf https://astral.sh/uv/install.sh | sh）

実行後、インストールされたものと、すでにインストール済みだったものをユーザーに伝えます。

フェーズ 2 — CLI の認証

各 CLI の認証状態を確認し、必要に応じて認証します。

gh auth status 2>&1

• 現在ログイン中のアカウントやトークンのスコープなど、出力全体をユーザーに表示します。
• 未認証の場合 → ユーザーに「gh auth login を実行し、プロンプトに従ってください。」と伝えます。
• gh auth login を自動実行してはいけません（対話型入力が必要です）。

glab auth status 2>&1

• GitLab インスタンス、現在のユーザー、トークンの有効性など、出力全体をユーザーに表示します。
• 未認証の場合 → ユーザーに「glab auth login を実行し、プロンプトに従ってください。」と伝えます。
• glab auth login を自動実行してはいけません。

フェーズ 3 — Jira 用の mcp-atlassian の設定

ステップ 3.1 — uvx が利用可能か確認する：

uvx --version 2>&1 || ~/.local/bin/uvx --version 2>&1

見つからない場合は、フェーズ 1 のスクリプト実行後にシェルを再起動するか、~/.bashrc / ~/.profile を読み込むようユーザーに伝えます。

ステップ 3.2 — 既存の OpenCode 設定を読み込む：

Read ツールを使って ~/.config/opencode/opencode.json を読み込みます。

• ファイルが存在しない場合は、{} として扱います。
• mcp.mcp-atlassian がすでに存在する場合は、ユーザーに確認してフェーズ 3 の残りをスキップします。

ステップ 3.3 — 認証情報を収集する（未設定の場合）：

以下の 2 つの質問を 1 つのメッセージでユーザーに尋ねます。

1. Jira URL — デフォルトは https://jira.dedalus.com/（Server/Data Center）です。Enter キーを押すとこの値が適用されます。
2. Jira Personal Access Token（PAT） — 発行手順：
   • Jira インスタンスにログインします
   • Profile → Personal Access Tokens に移動します
   • Create token をクリックし、名前を付けて有効期限を設定します
   • トークンをコピーして、ここに貼り付けます

Jira Cloud ユーザーの場合：PAT の代わりに JIRA_USERNAME（メールアドレス）と JIRA_API_TOKEN（https://id.atlassian.com/manage-profile/security/api-tokens から取得）を使用します。

ステップ 3.4 — 設定を書き込む：

既存の内容を保持したまま、mcp-atlassian ブロックを ~/.config/opencode/opencode.json に統合します。Write ツールを使って最終的な JSON を書き込みます。

Server/Data Center（デフォルト）の場合：

{
  "mcp": {
    "mcp-atlassian": {
      "type": "local",
      "command": ["uvx", "mcp-atlassian"],
      "environment": {
        "JIRA_URL": "<jira-url>",
        "JIRA_PERSONAL_TOKEN": "<pat>"
      },
      "enabled": true
    }
  }
}

Cloud（ユーザーが指定した場合）の場合：

{
  "mcp": {
    "mcp-atlassian": {
      "type": "local",
      "command": ["uvx", "mcp-atlassian"],
      "environment": {
        "JIRA_URL": "<jira-url>",
        "JIRA_USERNAME": "<email>",
        "JIRA_API_TOKEN": "<api-token>"
      },
      "enabled": true
    }
  }
}

ステップ 3.5 — 設定ファイルを保護する：

chmod 600 ~/.config/opencode/opencode.json

フェーズ 4 — 概要

以下の表で明確な概要を表示します。

コンポーネント	状態
gh	インストール済み / すでに問題なし
glab	インストール済み / すでに問題なし
jq	インストール済み / すでに問題なし
uvx	インストール済み / すでに問題なし
gh auth	認証済み / 対応が必要
glab auth	認証済み / 対応が必要
mcp-atlassian	設定済み / すでに問題なし / スキップ

最後に「新しい MCP 設定を読み込むため、OpenCode を再起動してください。」と伝えます。