【Notion】NotionのJira連携のチケットが更新されない時の同期確認

NotionとJiraを連携していると、Jira側でチケットを更新したのにNotionのデータベースに反映されないトラブルが発生することがあります。この問題は同期の仕組みや権限設定に起因することが多く、適切な手順で切り分けることで解決できます。本記事では、連携がうまくいかない場合の原因特定方法と具体的な対処手順を解説します。

同期の基本的な仕組みを理解する

Notion-Jira連携のアーキテクチャ

NotionとJiraの連携は、Notionのデータベース内にJiraの課題を埋め込む方式で動作します。Notion側で「Jira連携データベース」を作成し、Jiraのプロジェクトやフィルターを指定すると、Notionが定期的にJira APIを呼び出してデータを同期します。同期は完全リアルタイムではなく、通常は数分程度の遅延が発生します。更新が即時に反映されない場合は、まずこのポーリング間隔を考慮する必要があります。

自動同期の条件

同期が行われるには、以下の条件がすべて満たされている必要があります。

• Notion側の連携が「接続済み」状態であること
• Jira側で該当の課題にアクセスできる権限を持っていること
• 同期対象となるフィールドやステータス変更がトリガー条件に合致していること
• JiraのWebhook(もしくはNotionのポーリング)が正常に動作していること

まずチェックすべき基本設定

Notion側の接続状態を確認する

Notionのデータベースページを開き、右上の「…」メニューから「データベースの設定」を選択します。「Jira連携」セクションで、現在の接続状態が「接続済み」と表示されているか確認します。もし「未接続」や「エラー」と表示される場合は、一度接続を解除して再設定を行います。

Jira側のアクセス権限を確認する

Jira連携に使用しているアカウント(通常はOAuthで認証したユーザー)が、該当のプロジェクトと課題に対して「参照」権限を持っている必要があります。Jiraの管理画面でプロジェクト権限を確認するか、管理者に依頼して権限を付与してください。特に、Notionの連携アカウントがプロジェクトから外されていないか注意します。

同期条件とトリガーを確認する

更新対象フィールドとステータス

Notionのデータベースには、Jiraから同期するフィールドを選択できます。デフォルトではタイトル、ステータス、担当者など主要フィールドのみ同期されます。カスタムフィールドを同期したい場合は、事前にNotionデータベースのプロパティ設定でマッピングする必要があります。また、Jiraで更新しても、同期対象に指定されていないフィールドの変更はNotionに反映されません。

プロジェクト制限とフィルター

連携設定時にJQLフィルターを指定している場合、その条件に合致する課題のみが同期されます。たとえば「status != Closed」と設定していると、クローズしたチケットは同期対象外となります。フィルターが原因で更新が反映されないケースもあるため、一度全ての課題を取得するフィルターに変更して動作確認してみてください。

トリガー条件	影響	確認方法
ステータスのみ変更	通常は同期されるが、カスタムワークフローではトリガーされない場合あり	Jiraの「課題の履歴」で更新時刻を確認し、Notionの更新時刻と比較
コメントの追加	デフォルトでは同期対象外(Notion側の設定で追加可能)	Notionのプロパティ設定に「コメント」フィールドがあるか確認
担当者の変更	同期されるが、Notion側で担当者プロパティが存在する必要あり	Notionデータベースのプロパティ一覧を確認

よくある失敗パターンと対処法

OAuthトークンの期限切れ

NotionのJira連携ではOAuth 2.0認証を使用しており、トークンには有効期限があります。期限切れになると同期が停止します。Notion側の連携設定画面に「接続済み」と表示されていても、内部でトークンエラーが発生している場合があります。一度連携を解除し、再度認証することで解決します。

カスタムフィールドのマッピング不足

JiraのカスタムフィールドをNotionに同期するには、明示的にマッピングする必要があります。連携設定時に「同期するフィールド」でカスタムフィールドを選択しないと、更新されてもNotionには反映されません。また、Notion側のプロパティ型がJiraのフィールド型と一致しているかも確認してください(例:ドロップダウン vs セレクト)。

権限不足による同期エラー

Notionの連携アカウントがJiraのプロジェクトで「参照権限」を持っていない場合、同期は行われません。特にJiraのプロジェクトがプライベートな場合や、グループ制限がかかっている場合に発生します。管理者に依頼して、連携アカウント(通常はメールアドレス)を適切なプロジェクトロールに追加してもらいましょう。

管理者に確認すべきポイント

Jiraのグローバル権限設定

Jiraのシステム管理者は、「アプリケーションのアクセス」でNotion連携アプリケーションに対して適切な権限(「参照」「更新」など)を付与する必要があります。また、JiraのOAuthコンシューマー設定で、NotionのクライアントIDが許可されているか確認します。

NotionのIntegration設定

Notionのワークスペース管理者は、[設定] > [連携サービス] > [Jira] で「このワークスペースでのJira連携を許可」がオンになっているか確認します。また、各データベースの「連携」メニューで、正しいJiraアカウントとプロジェクトが選択されているかも見直します。

ポーリング間隔の調整

NotionのJira連携には同期間隔の設定はありませんが、Jira側のWebhookを利用して即時同期を有効にすることができます。Jira管理画面で「システム」→「Webhook」から、Notionのエンドポイントを設定すると、課題更新時にNotionへ通知が飛びます。管理者にWebhook設定の有無を確認してみてください。

トラブルシューティング手順

下記の手順を順に実施し、どの段階で問題が解決するか確認します。

1. Notionのデータベースページで「…」→「データベースの設定」→「Jira」と進み、接続状態が「接続済み」と表示されているか確認します。
2. 手動同期を試す:データベースの右上にある「更新」ボタン(↻)をクリックして、即時同期を実行します。
3. Jira側で最新の更新が行われているか確認します。課題の「履歴」タブで更新日時と内容を確認します。
4. Notionのデータベースで該当課題を開き、各プロパティに正しい値が表示されているか確認します。特にJiraで変更したフィールドが空白になっていないかチェックします。
5. Jiraの他の課題で同様の更新を行い、同期されるかテストします。1つだけ同期されない場合は個別の課題に問題がある可能性があります。
6. ブラウザのキャッシュをクリアするか、別のブラウザでNotionを開いて表示を確認します。
7. 上記で解決しない場合、Notionの連携設定を一度削除し、再設定(OAuth認証からやり直し)を行います。

よくある質問

Q: 同期にどのくらい時間がかかりますか?
A: 標準で5〜10分程度の遅延があります。即時同期が必要な場合は、Jira側でWebhookを設定することで数十秒以内に反映されます。

Q: 削除したJira課題がNotionに残ったままです。どうすればよいですか?
A: デフォルトでは削除された課題は同期されません。手動でNotion側の該当行を削除するか、データベースの設定で「削除された課題を自動的に削除」にチェックを入れてください。

Q: 複数のJiraプロジェクトを同期できますか?
A: 1つのNotionデータベースでは1つのJiraプロジェクト(またはJQLフィルター)のみ同期できます。複数プロジェクトを同期したい場合は、データベースを分けてそれぞれ連携設定を行う必要があります。

まとめ

NotionとJiraの同期が更新されない場合、まずは接続状態と権限を基本から確認しましょう。次に同期条件(フィールドマッピングやフィルター)を見直し、必要に応じてOAuth再認証やWebhook設定を検討します。管理者と連携してJira側の権限やWebhookを確認することで、ほとんどの問題は解決します。本記事の手順を参考に、スムーズな連携運用を実現してください。

🧩

Notionトラブル完全解決データベース 共有、権限、データベース、Notion AI、インポートで止まる問題を横断的に確認できます。