AI souj for ai

Souj for AI

Turn your content into living map collections.

You've already written the food guides and filmed the travel videos. Now hand the link to your AI — Claude or ChatGPT. It reads the content, finds every place, resolves real coordinates, writes the notes, designs the map legend, and builds a Souj collection. You review it in the app and publish when you're happy. Already running collections? Your AI can maintain them too — add new places, update notes, even push one announcement to dozens of branch locations at once.

Connector URL https://mcp.souj.io/mcp

Setup happens in a desktop browser (about 2 minutes). The connection is tied to your AI account — connect once and it works in the Claude app on your phone too.

01 how it works

Getting started

Three steps to connect.

01
Connect

Add the Souj connector in your AI (guides below). The first use opens the Souj authorization page — sign in with the same account you use in the app and approve.

02
Drop content

Paste an article or video link: "Turn the places in this post into a Souj collection." The AI creates the collection, adds each place, writes notes, keeps your ranking order, and designs the legend.

03
Review & publish

Everything the AI creates starts private. Open the Souj app, review and tweak, then flip it public yourself — publishing is always your call.

Try saying:

  • "Turn the restaurants in this article into a Souj collection, ordered by the article's ranking."
  • "Read this video, write a note for each place, mark must-eats red and cafés blue, and set the legend."
  • "Merge my last three Okinawa posts into one 'Okinawa Trip' collection."
  • "Post this anniversary-sale announcement to every northern branch in my store map."
02 setup guides

Per-client guides

Which AI do you use?

Claude (claude.ai / desktop app)
  1. On your computer, open claude.ai (or the Claude desktop app) → Settings → ConnectorsAdd custom connector
  2. Name it Souj and paste https://mcp.souj.io/mcp as the URL
  3. Keep the detected defaults: Authentication Always required, OAuth client register automatically
  4. Start a chat — the first use opens the Souj authorization page. Sign in, approve, done
ChatGPT (Plus or above, set up on the web)
  1. Custom connectors require Developer Mode: Settings → Connectors → Advanced
  2. Add a connector with https://mcp.souj.io/mcp as the URL and OAuth as authentication
  3. Complete the Souj authorization when prompted (menu paths may change between OpenAI releases — see their official docs)
Gemini

Google hasn't opened custom connectors in consumer Gemini yet. The Souj connector will work as soon as they do — this page will be updated with a guide.

03 safety

Safety & privacy

You authorize. You review. You publish.

  • Standard OAuth — your AI receives an access token you approve; Souj never shares your password with the AI, and the AI never handles it.
  • Your own content only — the AI gets the same permissions as you signing into the app: it can create and edit your collections, nothing else.
  • Private by default — AI-created collections are never public on their own. Publishing happens by your hand in the app, and the AI cannot flip a collection public.
  • No made-up coordinates — every place's coordinates come from a real map link (Google Maps, Apple Maps, OpenStreetMap, Amap). The AI cannot supply coordinates out of thin air.
  • Announcements are the one immediate action — an announcement notifies the people who bookmarked you right away, exactly as if you posted it in the app. The AI is instructed to confirm the final text with you before sending, and daily announcement limits are the same as in the app.
  • Revocable anytime — see and remove any connected AI in the app under Settings → AI assistant.
04 faq

Frequently asked

FAQ

Do I need a paid AI plan?

The Souj side is completely free. On the AI side: ChatGPT custom connectors require Plus or above; for Claude, see Anthropic's connector documentation for current plan support.

Will my content be used to train AI?

Souj never provides your data for AI training. How your conversation with the AI itself is handled is governed by your AI provider's (Anthropic / OpenAI) privacy terms.

Can the AI mess up my stuff?

The AI operates only under your authorized account, collections start private and cannot be made public by the AI, and the final publish is always yours. You can edit or delete anything in the app at any time.

What is MCP?

Model Context Protocol — an open standard that lets AI assistants safely connect to external services. The Souj connector is an MCP server. You don't need to understand it; just paste the URL following the guides above.

New to Souj?

Get the app first,
then connect your AI.

The AI assistant uses your Souj account — sign up on your phone first, then come back and follow the guide.