MCPで繋ぐ

maplist はリモートMCPサーバーです。AIエージェントに接続すると、エージェントが読み取った店をツール呼び出しでリストに追加し、共有URLを返します。

しくみ

やりとりは3つの層に分かれています。

  1. エージェント(ClaudeやClaude Code)が、スクショ・テキスト・URLから店名と住所を読み取る
  2. maplist のMCPツールが、店をリストに保存し、座標とGoogleマップへのリンクを付ける
  3. 共有ページ https://maps.iy-tech.work/l/<id> が、地図とカードでリストを表示する。見る側にログインは不要
接続に必要なもの: MCPのエンドポイント https://maps.iy-tech.work/mcp と、GitHubアカウントによるログインです。現在は招待制で、許可されたGitHubアカウントだけがツールを使えます。閲覧はURLを知っていれば誰でもできます。

Claude に繋ぐ

  1. claude.ai をブラウザで開き、設定 → コネクタ → カスタムコネクタを追加 を選ぶ
  2. URLに https://maps.iy-tech.work/mcp を入れる。認証は「今すぐサインイン」、OAuthクライアントは「自動的に登録」のまま
  3. maplist の承認画面が出るので許可し、続けてGitHubでログインする
  4. コネクタが有効になったら、新しい会話で「このスクショの店をリストにして」のように頼む

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

ピンを正確に立てる

座標は次の優先順で決まります。上にあるものほど正確です。

  1. エージェントが渡した lat / lng
  2. maps_url に含まれる座標(@35.66,139.70 や !3d…!4d… の形)
  3. 住所からのジオコーディング。日本の住所は国土地理院の住所検索、それ以外はOpenStreetMapのNominatim

店名だけではピンは立ちません。エージェントに住所を調べてもらうか、GoogleマップのURLを渡してください。京都の「通り名」で書かれた住所は解決できないことがあるので、その場合は緯度経度を直接渡すのが確実です。

ピンが立たなかった店は get_list の結果に pin: なし と出ます。住所を足したあとは refresh_pins でまとめて取り直せます。

公開範囲とプロフィール

値見られる人
private自分だけ。マイページにログインしている本人以外には404
unlistedURLを知っている人なら誰でも
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のデータは保存していません。