MCPで繋ぐ
maplist はリモートMCPサーバーです。AIエージェントに接続すると、エージェントが読み取った店をツール呼び出しでリストに追加し、共有URLを返します。
しくみ
やりとりは3つの層に分かれています。
- エージェント(ClaudeやClaude Code)が、スクショ・テキスト・URLから店名と住所を読み取る
- maplist のMCPツールが、店をリストに保存し、座標とGoogleマップへのリンクを付ける
- 共有ページ
https://maps.iy-tech.work/l/<id>が、地図とカードでリストを表示する。見る側にログインは不要
https://maps.iy-tech.work/mcp と、GitHubアカウントによるログインです。現在は招待制で、許可されたGitHubアカウントだけがツールを使えます。閲覧はURLを知っていれば誰でもできます。Claude に繋ぐ
- claude.ai をブラウザで開き、設定 → コネクタ → カスタムコネクタを追加 を選ぶ
- URLに
https://maps.iy-tech.work/mcpを入れる。認証は「今すぐサインイン」、OAuthクライアントは「自動的に登録」のまま - maplist の承認画面が出るので許可し、続けてGitHubでログインする
- コネクタが有効になったら、新しい会話で「このスクショの店をリストにして」のように頼む
Webで追加したコネクタは、iOS / Android のClaudeアプリにも同期されます。スマホでスクショを貼って使うのが一番手軽です。
Claude Code に繋ぐ
ターミナルで次を実行します。初回のツール呼び出し時にブラウザが開き、GitHubでログインします。
claude mcp add --transport http maplist https://maps.iy-tech.work/mcp
接続状態は /mcp コマンドで確認できます。ログインのやり直しも同じ画面からできます。
他のMCPクライアント
Streamable HTTP と OAuth 2.1(PKCE S256、動的クライアント登録)に対応したクライアントなら接続できます。
| 項目 | 値 |
|---|---|
| エンドポイント | https://maps.iy-tech.work/mcp |
| 認可サーバーのメタデータ | https://maps.iy-tech.work/.well-known/oauth-authorization-server |
| クライアント登録 | https://maps.iy-tech.work/register(redirect URI は Claude のもの、または http://localhost:<port>/callback のみ受け付けます) |
| トランスポート | Streamable HTTP(SSEも可) |
ツール一覧
| ツール | 種別 | 内容 |
|---|---|---|
create_list | 書き込み | リストを作って共有URLを返す。visibility が必須。最初の店も同時に入れられる |
add_places | 書き込み | 既存のリストに店を追加する(1回20件まで)。同名の店は追加せず skipped として返す |
get_list | 読み取り | リストの内容を店ごとのIDとピンの有無つきで読む |
list_lists | 読み取り | 自分のリストを新しい順に一覧する |
update_list | 書き込み | タイトル・説明・公開範囲を変える |
update_place | 書き込み | 店1件を直す。住所やメモの追記、緯度経度の指定 |
refresh_pins | 書き込み | 座標のない店をまとめて座標化し直す |
remove_place | 破壊的 | 店1件を消す。元に戻せない |
get_profile | 読み取り | 自分のプロフィールと、そこに載る公開リスト |
set_profile | 書き込み | プロフィールページ /u/<handle> を作る・直す |
リスト自体の削除はありません。消したいリストは visibility を private にしてください。
店として渡せる項目
| 項目 | 説明 |
|---|---|
name | 店名。必須 |
address | 住所。日本国内は番地まで書くと座標が正確に決まる |
area / category | 短いタグ。「下北沢」「カフェ」など |
note | ひとことメモ。誰に聞いたか、何が良いか |
maps_url | 実在するGoogleマップのURL。座標が含まれていればそれを使う |
lat / lng | 緯度経度。確実に分かるときだけ |
source_url | 出典。Instagramの投稿やブログのURL |
ピンを正確に立てる
座標は次の優先順で決まります。上にあるものほど正確です。
- エージェントが渡した
lat/lng maps_urlに含まれる座標(@35.66,139.70や!3d…!4d…の形)- 住所からのジオコーディング。日本の住所は国土地理院の住所検索、それ以外はOpenStreetMapのNominatim
店名だけではピンは立ちません。エージェントに住所を調べてもらうか、GoogleマップのURLを渡してください。京都の「通り名」で書かれた住所は解決できないことがあるので、その場合は緯度経度を直接渡すのが確実です。
ピンが立たなかった店は get_list の結果に pin: なし と出ます。住所を足したあとは refresh_pins でまとめて取り直せます。
公開範囲とプロフィール
| 値 | 見られる人 |
|---|---|
private | 自分だけ。マイページにログインしている本人以外には404 |
unlisted | URLを知っている人なら誰でも |
public | 誰でも。あなたのプロフィールページにも並ぶ |
プロフィールページは set_profile でハンドルを決めると https://maps.iy-tech.work/u/<handle> にできます。載るのは public のリストだけです。自分のリスト一覧は https://maps.iy-tech.work/me(GitHubログイン)で見られます。
よくある質問
Googleマップの「保存済み」リストに入れられますか?
入れられません。Googleが保存リストのAPIを公開していないためです。代わりに各店に「Googleマップで開く」リンクが付きます。
Instagramの投稿URLを渡しても店が拾えません
Instagramは外部から本文を取得できないことが多いので、投稿のスクショを渡してください。
地図のデータはどこから来ていますか?
地図は OpenStreetMap、タイルは OpenStreetMap Japan です。店の情報はすべてエージェントが読み取ったもので、Googleのデータは保存していません。