始める前に
- Marqab ワークスペースのオーナーまたは管理者である必要があります。
- 接続したあと、ソースをプロダクトにマップします。未マップのリポジトリとプロジェクトは無視されます。
- 新しい接続やマップは直近90日を取り込みます。
- Webhook シークレットは一度だけ表示されます。同じ日にプロバイダ側も更新できるときだけローテートしてください。
GitHub
マージされたプルリクエストと公開リリースが、アクティビティ、ダイジェスト、リリースノートになります。
セットアップ
- 設定 → 連携 → GitHub。オーナーと管理者のみ。
- Install GitHub App を選び、組織またはリポジトリを指定します。
- 各リポジトリ（owner/repo）をプロダクトにマップします。
- Marqab が直近90日のマージ済み PR を取り込みます。新しいマージとリリースはそのまま届きます。
それ以外。 GitHub Enterprise、または App ボタンがない場合：個人トークンを貼り、必要なら API URL を設定し、プルリクエストとリリースの Webhook を追加します。
切断
切断すると App 連携または PAT が削除されます。リポジトリ→プロダクトのマッピングは残ります。
再接続
App を再インストール（または新しい PAT を貼付）。マッピングを消した場合のみ再マップ。
GitLab
マージされたマージリクエスト、リリース、タグのプッシュが同じアクティビティとリリースノートになります。
セットアップ
- 設定 → 連携 → GitLab。
- Connect with GitLab を選び、gitlab.com で Marqab を許可します。
- 各プロジェクトをプロダクトにマップします。Marqab がプロジェクト Webhook を登録します。
- 直近90日のマージ済み MR が取り込まれます。
それ以外。 セルフホストの GitLab、または Connect がない場合：個人トークンを貼り、ベース URL を設定し、プロジェクトをマップして Webhook を追加します。
切断
切断すると OAuth または PAT が消えます。プロジェクトのマッピングは残ります。
再接続
GitLab で再接続（または PAT を貼付）。プロジェクトフックが消えていればマッピングを保存し直す。
Jira
Done に移った Issue はクローズしたチケットになります。未完了はプロダクトページに出せます。
セットアップ
- 設定 → 連携 → Jira。
- サイト URL、Atlassian のメール、API トークンを入力します。
- 各プロジェクトキーをプロダクトにマップします。
- Marqab が表示する Webhook を追加します（Issue updated）。
それ以外。 Marqab の Forge アプリが入っている場合は Cloud ID も貼り、画面に Marqab のプロダクトフィールドを追加します。
切断
切断すると Marqab から API トークンが削除されます。再接続しない場合は Jira の webhook も更新／削除。
再接続
サイト URL・メール・新しい API トークンを入力。Forge 利用時は Cloud ID も再度貼付。
Sentry
新規・再発の Issue と解決がプロダクトに載ります。未解決をライブ表示できます。
セットアップ
- 設定 → 連携 → Sentry。表示があれば Marqab アプリを入れるか、内部インテグレーションをつなぎます。
- 内部インテグレーションでは Project、Issue & Event、Organization Read を付与し、Issue の Webhook を有効にします。
- トークンと Client Secret を貼り、org スラッグを設定します。
- 各 Sentry プロジェクトスラッグをプロダクトまたはコンポーネントにマップします。
それ以外。 内部インテグレーションは、Marqab が表示するワークスペースごとの Webhook URL を使います。
切断
切断するとインストールまたはトークンが解除されます。マッピングは残ります。
再接続
Sentry App を再インストールするか、新しい内部トークンと Client Secret を貼付。
Slack
選んだチャンネルにリリース要約と月曜のダイジェストを投稿します。取り込むものはありません。
セットアップ
- Marqab の Slack アプリを入れ、Bot User OAuth Token をコピーします。
- 設定 → 連携 → Slack：トークンとチャンネル（例 #releases）を貼ります。
- 任意で Slack ワークスペースを設定すると、オーナーの「Slack で開く」が動きます。
- 接続をテストします。リリースはその場で投稿。ダイジェストは月曜 09:00 UTC です。
それ以外。 ボットトークンが要らなければ Incoming Webhook URL でも動きます。
切断
切断すると Marqab の投稿が止まります。Slack からアプリを削除しても構いません。
再接続
新しい bot トークンまたは webhook とチャンネルを貼り、接続をテスト。
切断と再接続
- オーナー／管理者: プロバイダーを開き → 切断。保存済み認証は削除されます。マッピングは残ります。
- インストール／接続（または貼り付け）で再接続。新しい接続やマッピングは直近90日をバックフィルします。
- 読み取り専用ワークスペースでも切断とテストは可能です。接続にはプラン変更が必要な場合があります。
困ったときは
設定 → ヘルプとサポート、または Support。このサイトの法務ページは英語です。 Support