<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Ray Lei</title>
    <description>The latest articles on DEV Community by Ray Lei (@raylei).</description>
    <link>https://dev.to/raylei</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4237891%2F3d88f79a-9f0d-497c-bfe1-250c3f1f7e11.png</url>
      <title>DEV Community: Ray Lei</title>
      <link>https://dev.to/raylei</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/raylei"/>
    <language>en</language>
    <item>
      <title>Connect Your AI Assistant to Your Restaurant Menus: A Hands-On Remote MCP Server Example</title>
      <dc:creator>Ray Lei</dc:creator>
      <pubDate>Tue, 17 Nov 2026 18:26:40 +0000</pubDate>
      <link>https://dev.to/raylei/connect-your-ai-assistant-to-your-restaurant-menus-a-hands-on-remote-mcp-server-example-5h50</link>
      <guid>https://dev.to/raylei/connect-your-ai-assistant-to-your-restaurant-menus-a-hands-on-remote-mcp-server-example-5h50</guid>
      <description>&lt;p&gt;&lt;strong&gt;Short answer:&lt;/strong&gt; a remote MCP server is just a URL your AI client talks to over Streamable HTTP, with OAuth instead of an API key. This post walks through a real one, the &lt;a href="https://www.chef-bear.com/mcp/" rel="noopener noreferrer"&gt;ChefBear&lt;/a&gt; menu server, from install commands for five clients to the tool list and the permission design, so you can see what a small, consumer-facing remote server looks like end to end.&lt;/p&gt;

&lt;p&gt;I eat out a lot and photograph menus constantly. Those photos usually die in the camera roll. Connecting a menu app to my assistant turned out to be a nice, concrete way to understand remote MCP servers, because the data is small, personal and easy to reason about.&lt;/p&gt;

&lt;h2&gt;
  
  
  What is a remote MCP server?
&lt;/h2&gt;

&lt;p&gt;The Model Context Protocol (MCP) lets AI clients such as Claude, ChatGPT, Cursor or Gemini CLI call tools exposed by a server. A &lt;em&gt;remote&lt;/em&gt; server runs on someone else's infrastructure: there's nothing to install locally, the transport is Streamable HTTP, and authorization follows the &lt;a href="https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization" rel="noopener noreferrer"&gt;MCP authorization spec&lt;/a&gt;, which is OAuth 2.1 with PKCE.&lt;/p&gt;

&lt;p&gt;Here's the server used in this walkthrough:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;URL:&lt;/strong&gt; &lt;code&gt;https://chef-bear.com/api/menu-sharing/mcp&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Transport:&lt;/strong&gt; Streamable HTTP&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Auth:&lt;/strong&gt; OAuth sign-in. No API key, no header to set.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Registry name:&lt;/strong&gt; &lt;code&gt;com.chef-bear/chefbear&lt;/code&gt; in the official MCP Registry. The server card is at &lt;code&gt;https://chef-bear.com/api/menu-sharing/mcp/server-card&lt;/code&gt; and is listed in &lt;code&gt;/.well-known/ai-catalog.json&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;To complete sign-in you need an account in the app and its iPhone app (version 4.4 or later), because that's where the connection is approved.&lt;/p&gt;

&lt;h2&gt;
  
  
  How do I add a remote MCP server to my client?
&lt;/h2&gt;

&lt;p&gt;Name the server &lt;code&gt;chefbear&lt;/code&gt; wherever your client asks.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Claude Code&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;claude mcp add --transport http --scope user chefbear https://chef-bear.com/api/menu-sharing/mcp
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Start a new session, run &lt;code&gt;/mcp&lt;/code&gt;, pick &lt;code&gt;chefbear&lt;/code&gt; and choose &lt;strong&gt;Authenticate&lt;/strong&gt;. Newer versions also support &lt;code&gt;claude mcp login chefbear&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Codex&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;codex mcp add chefbear --url https://chef-bear.com/api/menu-sharing/mcp
&lt;span class="c"&gt;# if the sign-in doesn't open by itself:&lt;/span&gt;
codex mcp login chefbear
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Cursor&lt;/strong&gt; — add to &lt;code&gt;~/.cursor/mcp.json&lt;/code&gt; (all projects) or &lt;code&gt;.cursor/mcp.json&lt;/code&gt; (one project):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"mcpServers"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;"chefbear"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"https://chef-bear.com/api/menu-sharing/mcp"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;VS Code&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;code --add-mcp &lt;span class="s1"&gt;'{"name":"chefbear","type":"http","url":"https://chef-bear.com/api/menu-sharing/mcp"}'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Gemini CLI&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;gemini mcp add --scope user --transport http chefbear https://chef-bear.com/api/menu-sharing/mcp
&lt;span class="c"&gt;# then, inside Gemini CLI:&lt;/span&gt;
/mcp auth chefbear
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Claude (web, desktop, mobile) and ChatGPT&lt;/strong&gt; don't need any of this: the server is in Claude's connector directory and available as a ChatGPT plugin. The server's install page (linked at the end) has one-click links for each client, plus steps for Google Antigravity.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Any other MCP client:&lt;/strong&gt; add a remote server with the URL above and choose Streamable HTTP and OAuth. One constraint: the client has to finish OAuth with a &lt;strong&gt;localhost callback&lt;/strong&gt; on your own machine. Clients that redirect to a hosted web URL can't connect.&lt;/p&gt;

&lt;h2&gt;
  
  
  How does the OAuth sign-in work?
&lt;/h2&gt;

&lt;p&gt;When your client starts the OAuth flow, the browser opens a sign-in page that hands off to the phone:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;On an iPhone, tap the button that opens the app. On a computer, scan the QR code with your iPhone camera.&lt;/li&gt;
&lt;li&gt;In the app, review what the client is asking for and tap &lt;strong&gt;Allow&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;The client receives its token and you're done.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;There is no code to type and nothing to paste into the chat, and the assistant never sees a password. That's a good property in general. "Paste the code here" is exactly the kind of instruction a prompt-injected agent might relay, and the simplest defense is a flow with no code in it.&lt;/p&gt;

&lt;h2&gt;
  
  
  What tools does the server expose?
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Tool&lt;/th&gt;
&lt;th&gt;What it does&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;import_menu&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Reads 1–5 menu photos into a private menu (asynchronous)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get_import_status&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Polls an import until the menu is ready&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;save_menu&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Saves a menu the assistant already read from a photo or text&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;list_menus&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Lists saved menus, newest first (separate permission)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get_menu&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Reads one saved menu: dishes, short descriptions, categories, prices&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get_shared_menu&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Reads a menu link someone shared with you&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;share_menu&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Turns on a public link for a menu, only when asked&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;revoke_menu_share&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Turns that link off; the private menu stays&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;connection_status&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Checks the connection and what it's allowed to do&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;In Claude (web, desktop and mobile, but not Claude Code) there are three more tools, &lt;code&gt;get_taste_profile&lt;/code&gt;, &lt;code&gt;update_taste_profile&lt;/code&gt; and &lt;code&gt;recommend_dishes&lt;/code&gt;, behind separate taste-profile permissions granted on the approval page.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;import_menu&lt;/code&gt; + &lt;code&gt;get_import_status&lt;/code&gt; is a pattern worth noticing: vision processing of several photos can take longer than a client wants to wait on one tool call, so the server returns a job and the model polls. Models handle this well if the tool description says plainly "call get_import_status until status is ready."&lt;/p&gt;

&lt;h2&gt;
  
  
  What can I ask once it's connected?
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;"Check my menu connection and tell me what you're allowed to do." A good first call, because it hits &lt;code&gt;connection_status&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;"Import this menu photo and tell me which dishes are vegetarian."&lt;/li&gt;
&lt;li&gt;"List my last three menus and summarize each in one line."&lt;/li&gt;
&lt;li&gt;"Read this shared menu link and pick two dishes for someone who doesn't like spicy food."&lt;/li&gt;
&lt;li&gt;"Turn off the share link for last night's menu."&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In Claude Code or Cursor this is mostly a curiosity, but it's a handy way to inspect real tool schemas and descriptions before you design your own.&lt;/p&gt;

&lt;h2&gt;
  
  
  What design choices are worth borrowing for your own server?
&lt;/h2&gt;

&lt;p&gt;If you're building a remote MCP server for a consumer app, a few choices in this one generalize well:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;1. Approve in an app the user already trusts.&lt;/strong&gt; Approval happens in the phone app, not in a web form an agent opened. No shared secret exists for an agent to ask for.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2. Make enumeration a separate scope.&lt;/strong&gt; Reading a menu you point to (&lt;code&gt;get_menu&lt;/code&gt;) and listing everything you've saved (&lt;code&gt;list_menus&lt;/code&gt;) are different levels of access. Here, listing is its own grant ("See a list of your saved menus"). The underlying OAuth scopes are separate too (&lt;code&gt;menus:read&lt;/code&gt;, &lt;code&gt;menus:list&lt;/code&gt;, and so on), which you can see in &lt;code&gt;connection_status&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. Never make anything public without an explicit ask.&lt;/strong&gt; &lt;code&gt;share_menu&lt;/code&gt; only runs when the user asks for a link, and &lt;code&gt;revoke_menu_share&lt;/code&gt; is always available. Revoking the link doesn't delete the private menu.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;4. Say what the server won't do.&lt;/strong&gt; This server never books tables, places orders or takes payments. Writing that into tool descriptions keeps models from overpromising.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;5. Publish machine-readable discovery.&lt;/strong&gt; A server card, an &lt;code&gt;ai-catalog.json&lt;/code&gt; entry and an &lt;code&gt;llms.txt&lt;/code&gt; that spells out the URL, the auth model and &lt;em&gt;which&lt;/em&gt; product this is. Name collisions are real: several unrelated apps share similar names, and an agent asked to install one by name needs a way to pick the right one.&lt;/p&gt;

&lt;h2&gt;
  
  
  What are the limits?
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;The approval step needs an iPhone; there's no Android app.&lt;/li&gt;
&lt;li&gt;Accounts in the mainland China service region can't connect.&lt;/li&gt;
&lt;li&gt;Taste-profile tools are available in Claude only for now.&lt;/li&gt;
&lt;li&gt;Dish details come from the restaurant's menu, so allergens still need to be confirmed with the restaurant.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Do remote MCP servers need an API key?&lt;/strong&gt;&lt;br&gt;
No. The MCP authorization spec is OAuth-based, and many remote servers, this one included, use OAuth only, so there's no key to store.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Why does my client fail with a redirect error?&lt;/strong&gt;&lt;br&gt;
Some servers only accept OAuth redirects to &lt;code&gt;localhost&lt;/code&gt; on your machine. If your client redirects to its own hosted URL, the server will reject it. Check whether the client supports local callbacks or client metadata documents.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;What's the difference between Streamable HTTP and stdio?&lt;/strong&gt;&lt;br&gt;
stdio servers run as a local process launched by your client. Streamable HTTP servers are reached over the network, which is what makes a hosted, OAuth-protected server possible.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Can the assistant share my data without asking?&lt;/strong&gt;&lt;br&gt;
With this server, sharing is a separate tool call that's only made on request, and any share link can be revoked.&lt;/p&gt;

&lt;h2&gt;
  
  
  Try it
&lt;/h2&gt;

&lt;p&gt;The install guide with one-click links for every client is on the &lt;a href="https://www.chef-bear.com/mcp/" rel="noopener noreferrer"&gt;ChefBear&lt;/a&gt; MCP page. If you connect from a client that isn't listed, or the OAuth flow fails somewhere, drop it in the comments. Client quirks around localhost callbacks are exactly what's worth collecting.&lt;/p&gt;

</description>
      <category>mcp</category>
      <category>ai</category>
      <category>oauth</category>
      <category>tutorial</category>
    </item>
  </channel>
</rss>
