- ロジック
- 構造
- 監査
- 手動操作
すぐに答え
AIでTinybirdの変換処理をデバッグするには?
エージェントがパイプの定義とノード構造を取得し、ロジックの失敗箇所を特定します。問題を引き起こしている具体的なノードを特定できるため、修正すべきSQLがすぐに分かります。エラーの発生源を明確に把握できます。
エラーの所在
デバッグによる成果
AIがパイプラインを解析し、データ問題の根本原因を特定します。
ロジック
SQLエラーの検出
エージェントがパイプの定義を読み取り、変換処理における構文エラーや論理的な欠陥を見つけ出します。
構造
ノードの失敗箇所を特定
パイプライン内のどの特定のノードでデータの欠落やエラーが発生しているかを特定します。
監査
パイプラインの棚卸し
利用可能なすべてのパイプとその内部構成をリストアップし、データフローの全体像を把握できます。
手動操作
手動での修正が必要
AIは破損したコードを特定しますが、修正を適用するにはTinybird上で直接SQLを編集する必要があります。
ワークフロー
エラー発生時にAIが行うこと
UIを一つずつクリックして探す代わりに、エージェントがTinybirdの設定をスキャンしてエラー箇所を見つけ出します。
パイプのリストアップ
まず、調査範囲を把握するために、既存のパイプラインの一覧を取得します。
list_pipesパイプ構造の調査
特定のパイプを詳細に調べ、データが各ステージをどのように流れているかを確認します。
list_pipe_nodesSQLロジックの解析
パイプの完全なコードを取得し、変換ロジックにエラーがないか検証します。
get_pipe_details調査結果の報告
変換エラーを引き起こしている具体的なノードとコードの行をまとめて報告します。
get_pipe_details
試してみる
以下のプロンプトをコピーして開始
これらのプロンプトを使って、すぐにデバッグを開始できます。
出発点
パイプ名は、実際にお使いのTinybirdパイプの識別子に置き換えてください。
Tinybird Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_e9MOySIFrTyItsoZeoVkFv0IVVN3MSGs8AJqsvq5/mcpClaude Desktop
以下の手順で数秒で接続できます。
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Tinybird capabilities are ready to use.
{
"mcpServers": {
"tinybird-data-platform-mcp": {
"url": "https://edge.vinkius.com/vk_preview_e9MOySIFrTyItsoZeoVkFv0IVVN3MSGs8AJqsvq5/mcp"
}
}
}稼働中のパイプを確認したいので、すべてのTinybirdパイプをリストアップしてください。
'user_events_transform' パイプの詳細を教えてください。
'sales_aggregator' パイプのノードを確認し、どのノードが失敗しているか教えてください。
'realtime_metrics' パイプのSQLロジックを確認し、JOINが失敗している原因を特定してください。
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
ここから始める
一度接続すれば、あとは指示するだけ
一度接続するだけで、エージェントはTinybirdのパイプを完全に把握できるようになります。認証情報は暗号化され、安全に管理されます。
TinybirdをAIに接続するFAQ
デバッグの仕組みについて
- 01
AIがSQLコードを自動的に修正することはできますか?
いいえ。AIはエラーを特定して修正方法を提示しますが、Tinybird上のコードを更新するのはユーザー自身が行う必要があります。
- 02
AIがパイプを削除することはありませんか?
はい、ありません。提供されているツールはパイプの詳細や構造を読み取るためのものであり、AIが内容を変更したり削除したりすることはできません。
- 03
AIは生のデータ(Raw Data)を見ることができますか?
いいえ。AIがアクセスできるのは、パイプの定義、SQLロジック、およびノードの構造のみです。
- 04
AIはどのようにして故障しているノードを特定するのですか?
ノードのリストを使用して変換ステップをマッピングし、報告されたエラーとロジックを照らし合わせることで特定します。
- 05
Claudeで使用できますか?
はい。Vinkius経由で接続すれば、ClaudeやCursorなど、MCPに対応しているあらゆるクライアントで使用可能です。
Tinybirdに関するその他の質問は、コネクターのページで確認できます。 Tinybird Connectorの全機能を見る
『Tinybird』を Claude、Cursor、ChatGPT などに接続
