Advanced setup
Connection details
Use the guided setup for your AI first. This guide covers manual setup, troubleshooting, and the separate local Claude Desktop bundle.
Remote MCP connection
The hosted alpha connector uses this address:
https://app.shareless.ai/api/mcp/remote
Choose OAuth authentication in a compatible MCP client. Sign in to the same ShareLess account shown in Account on your iPhone, and check the account on the consent screen before connecting. Your AI account can use a different email. No app key is needed for this remote path.
- Claude: use the prefilled connection form, or open Customize → Connectors → Add custom connector. If authentication options appear, choose Sign in now and Register automatically. Complete OAuth, then enable ShareLess under + → Connectors in your chat.
- ChatGPT: on a computer, open Plugins → + → Add custom MCP server. Enter the name and description, add this URL under Connection, and select OAuth. Review the warning and create the plugin, then complete ShareLess sign-in. Review the tools, install ShareLess, and select it with @ in a new conversation. Account and workspace policies apply; a read-only connection cannot place an order. The public directory does not list this connection yet. See ChatGPT's current setup guide.
- Meta Muse: copy the setup message, paste it in Muse and send it. It asks for OAuth setup and tool discovery only.
On Team or Enterprise accounts, your workspace may require an administrator to enable or add a custom connector. Claude Free allows one custom connector. Use Claude web or desktop for setup; mobile installation is still in beta. See Claude's current setup guide.
Check without sharing data
Confirm that the connection is enabled and its tools appear in your AI. The guided setup includes an optional prompt that calls ShareLess for its current capabilities without requesting saved values, a phone setup code, or an approval. A successful capabilities call checks the authenticated server connection; it does not prove that your phone is online.
When you choose to make a supported request, ShareLess applies your saved rules. A request that needs your decision appears on the phone with its reason and proposed release. A standing rule can allow some requests without another prompt. Review the result and receipt in your AI. Declined, expired, or unavailable requests should remain unsuccessful.
If setup does not finish
- Wrong ShareLess account: use another account on the consent screen. Check the email in the iPhone app; reconnecting the AI does not move data between ShareLess accounts.
- No custom connector option: check your AI's current plan and workspace permissions. ChatGPT's Developer mode and Claude's organization controls are managed by those services.
- Connection failed: check the exact server address and OAuth setting. Start from the guided setup, which uses one server address for every AI. If an older custom connection uses a different address, add the guided connection and remove the old one after the new connection works. Do not paste passwords, tokens, or app keys into chat.
- Tools appear but a request waits: open ShareLess on the iPhone signed in to the connected account. Check for the matching request and its expiry. A connection alone is not a phone availability check.
Optional: local Claude Desktop bundle
This is a separate path for people who want approved values opened on their own computer. It runs a local MCP server, rather than the hosted OAuth connector. It requires source build tools and an app key; it is not needed for the guided remote setup.
- From the ShareLess source checkout, build with
pnpm --filter @shareless/mcp-agent bundle. The output isservices/mcp-agent/build/shareless-vault.mcpb. - Open the
.mcpbfile in Claude Desktop, review its permissions, and install it. You can also use Settings → Extensions → Advanced settings → Install Extension. - In the ShareLess web console, open Account → Advanced: local connectors and app keys and use Create local Claude Desktop key to issue an app key. Copy it when shown.
- Enter the key in the bundle's ShareLess agent key setting, never in an AI conversation. The local connector uses this key to authenticate HTTPS requests to ShareLess. Keep it in the client's protected configuration.
Reissuing the app key replaces the previous key. The local bundle has its own tool surface; it is not a drop-in replacement for every hosted tool. See Claude's desktop extension guide for installation details.
Where approved information goes
Purchase tools send public items and choices to your phone. Your phone uses saved details on the merchant's page and returns the outcome, without releasing card, address or traveler values to your AI. Known blockers are returned as next steps. A successful tool call or a submitted form does not mean the merchant confirmed an order.
For a separate, deliberate sharing request on the hosted remote path, ShareLess opens approved values in memory to pass them to your AI and does not log or store that plaintext. The request's decryption key is held encrypted at rest while the request is pending and cleared when it completes or expires. The remote path is not server-blind.
On the local bundle path, approved values are opened on your computer. ShareLess relays ciphertext on that field-release path. Once a value reaches Claude or another AI, it has been shared with that provider. Disconnecting ShareLess cannot retrieve information already delivered.
Connecting your AI does not let ShareLess intercept unrelated tools, emails, posts, or purchases. For actions in an outside service, enforcement requires a separate destination connection and a path where ShareLess can execute only the approved action. See current coverage and limitations.
Manage your connections
Use Account for ShareLess connection management and your AI's settings to remove its connector. Your phone remains the place to review supported requests and manage your sharing rules.