Help
How to connect Atelier to an assistant, what buying a photograph involves, and where your account lives.
Connecting an assistant
How do I connect Atelier to Claude?
Atelier is added to Claude once, as a connector, and is then there in any conversation.
- In Claude, open Settings, then Connectors.
- Choose Add custom connector, name it Atelier, and paste this address:Connector address
https://store.atelierphotos.app/api/mcp - Add it. Claude may ask you to sign in now, or not until you first buy something; either way it is the email sign-in described below.
- In a conversation, check that Atelier is switched on in the tools menu, then ask for what you need — a quiet green photograph for my phone’s lock screen.
Claude’s desktop and mobile apps use the connectors on your Claude account, so there is nothing to add twice. If you do not see Add custom connector, your Claude workspace may limit which connectors can be added; ask whoever manages it.
How do I add it to Claude Code?
Run this in a terminal:
claude mcp add --transport http atelier https://store.atelierphotos.app/api/mcpThen, inside Claude Code, run /mcp and choose Atelier to sign in. You only need to before buying; searching works without it.
How do I connect it to ChatGPT?
ChatGPT adds a connector by its address in developer mode, on the web. Which plans have developer mode, and whether a connector there may do more than read, is OpenAI’s to decide: if ChatGPT will search Atelier but not buy, that is the reason.
- In ChatGPT on the web, open Settings and turn on Developer mode, under Security and login. In a work or school workspace, an admin may have to allow it first.
- Open Plugins, choose +, name it Atelier, and paste this address as its connection:Connector address
https://store.atelierphotos.app/api/mcp - If it asks how to authenticate, choose OAuth. ChatGPT may ask you to sign in now; it is the email sign-in described below.
- In a new conversation, open the + menu beside the message box, choose Developer mode, and switch Atelier on. It stays on for that conversation only.
ChatGPT’s phone apps do not use connectors added this way. Its menus have moved more than once; if one is not where this says, search ChatGPT’s help for developer mode.
How do I connect it to Muse?
Muse, Meta’s assistant, adds a service it does not list as a custom connector, and you ask for one in a conversation.
- Send Muse this message:Message
Add a custom connector named Atelier: a remote MCP server over streamable HTTP at https://store.atelierphotos.app/api/mcp, signing in with OAuth. - Muse opens Atelier’s sign-in page. It is the email sign-in described below.
- Ask for what you need — a quiet green photograph for my phone’s lock screen.
If your Muse app has Add custom connector under Settings, Connectors, pasting the address there does the same. You can disconnect Atelier on that page, or on your account page.
Can I use another assistant, or an agent I built?
Yes. The address is a remote MCP server over HTTP, so any client that can add one by its address can use Atelier. Signing in is the standard OAuth flow, which the client starts itself the first time it needs your account.
If your agent can only send a fixed key, make an API key on your account page and send it in the Authorization header, as Bearer followed by the key. A key is shown once, can buy on your behalf, and can be revoked on the same page; you can have five at a time.
Do I need an account just to look?
No. Searching, previews and the license need no account. Your assistant asks you to sign in the first time you buy, check your credits, or download something you own.
How does signing in work?
There is no password. Atelier emails you a link and a six-digit code. Open the link, or type the code on the page that asked for it — the code is for when the email arrives on a different device from the one you are signing in on. The assistant is then connected to the same account you see on your account page.
Finding and buying
How do I buy a photograph?
Ask your assistant for what you need. It shows you previews — some apps do not display pictures in the conversation, so it also gives you a link to open each one. Choose a frame, and the assistant tells you what it costs, checks your credits, and asks you before spending any.
With no credits, it gives you a checkout link instead: to pay for that one photograph by card, where its collection allows it, or to subscribe.
Does my assistant see my card?
No. You pay on a Stripe checkout page that you open yourself. The assistant never sees the page or your card; it only learns that the payment went through.
Is there a free trial?
A new account can claim 3 credits free, once per email address, to try the store before paying for anything. They work only in collections whose photographer has allowed it, and your assistant will tell you whether the frame you chose is one. A photograph bought with free credits comes as the screen file only; your assistant can buy its print file afterwards, at the photograph’s usual price. An account that has already paid for something is not offered the trial.
What do I get when I buy?
Two files of the whole frame, uncropped:
- A screen file, 2560 pixels, for wallpapers, lock screens and backgrounds.
- A print file: the photographer’s original file, at full resolution.
Both are named after the photograph and its photographer. The download links work for 24 hours; ask again at any time for fresh ones, which costs nothing.
Can I download a photograph again later?
Yes, for as long as you need it. Ask your assistant, or sign in to your account page — Your images has both files for everything you own.
What am I allowed to do with it?
Use the image on your own devices and in personal projects, with no expiry. Credit the photographer where practical. No resale, no redistribution, no commercial use, no AI training. Read the license for the full list and its text. Using a photograph for a business needs the commercial license, below.
Can I use a photograph for my business?
Not under the personal license. Where a photograph’s gallery offers it, buy its commercial license instead: use the image to promote and run a business — websites, social media, advertising, marketing and client work — with no expiry. Licensed to one named person or business. No merchandise or templates for resale, no redistribution, no AI training.
- Tell your assistant the photograph is for a business — it can search for only the frames that offer a commercial license, and tells you the price.
- It gives you a checkout link. The commercial license is paid by card only; credits and subscriptions do not buy it. The checkout page asks who the license is for — you, or your business — and for a VAT or tax number if you have one.
- Once paid, your assistant delivers the same two files. On your account page, the photograph is marked with its commercial license and has a certificate to keep on file: the licensee, the photograph, the date and the terms you bought under.
If you already own the personal license, the commercial one is a separate purchase at its own price. No model or property release comes with it. Prints, posters or merchandise for sale are not covered — the license has the full list.
Credits and subscriptions
How do credits and subscriptions work?
A subscription adds credits each month, and each photograph costs a number of credits shown before you buy. What you buy is yours to keep, including after you cancel. The plans and their prices are on the pricing section.
Can I spend credits on the website?
Not yet. Credits are spent through an assistant, or an agent using one of your API keys. Your account page shows your balance and everything you own, and downloads it.
How do I cancel or change my plan?
On your account page, Billing opens Stripe’s billing page, where you cancel, change plan, update your card and download invoices. Cancelling stops new credits and takes back nothing you bought.
Can I get a refund?
In the cases the Return Policy lists — a double charge, a file that could not be delivered, and a few others — within 14 days. A first subscription payment is refunded in full if you cancel within 14 days without spending any of its credits. A refund ends the license for what it paid for.
Your account
How do I disconnect an assistant?
On your account page, Connected apps lists every assistant you have signed in, and Disconnect removes one. API keys are revoked in the section below it.
How do I delete my account?
On your account page, Your data lets you download everything Atelier holds about you as a file, and delete the account. Deleting cancels any subscription at once and removes your purchases with it, so download what you want to keep first.
For developers
What is the connector, technically?
A remote MCP server over Streamable HTTP. It is stateless: no session id, and each response is a single JSON body rather than an event stream.
https://store.atelierphotos.app/api/mcptools/list and the four catalogue tools answer without a token, so a client can be tried before anyone signs in.
How does an agent authenticate?
OAuth 2.1: the authorization code flow with PKCE (S256), refresh tokens, and dynamic client registration, so no client needs to be registered by hand. Clients are public; there is no client secret. The metadata is at https://store.atelierphotos.app/.well-known/oauth-authorization-server.
There are two scopes:
catalog:read— search and see previews, which needs no token at all.purchase— the account: its balance, its images, spending credits, checkout and downloads.
A call to an account tool without a token gets a 401 whose WWW-Authenticate header points to the protected-resource metadata, which is what starts the client’s sign-in. A token without purchase gets a 403 with insufficient_scope.
An agent that cannot run OAuth can use an API key instead, as described above. A key carries the purchase scope.
What tools does it have?
search_imagesSearch the catalogue by description, mood, colour or subject, ranked for a destination screen size when one is given, or limited to images offered for commercial use. No account.get_imageOne listing by id, with its preview, price — and commercial price, where offered — and photographer. No account.list_collectionsThe public collections, to browse rather than search. No account.get_licenceThe terms of the personal license, or of the commercial one. No account.unlock_collectionOpen a private gallery to the account, with the link and access code its photographer gave. Signed in.get_accountCredit balance, plan, whether the free trial is available, and the account page address. Signed in, purchase scope.start_trialClaim the free trial credits. Signed in, purchase scope.create_checkoutA Stripe Checkout link for the person to open: credits, a subscription, or one image by card — under the personal license, or the commercial one where offered. Signed in, purchase scope.fulfil_imageBuy an image, or re-download one already owned, and return its download links. Signed in, purchase scope.list_entitlementsThe images the account owns. Signed in, purchase scope.
Each tool’s full description and input schema come from tools/list, with the standard annotations saying which tools only read and which change the account. The server’s instructions tell the agent to confirm with the person before spending credits.
What are the rate limits?
- 120 calls a minute.
- 30 calls a minute that return pictures:
get_image, andsearch_imagesunless it is passedinclude_previews: false.
Both are counted per token when there is one, and per IP address when there is not. Past either, the server answers 429 with Retry-After: 60 and a JSON-RPC error whose data.reason is rate_limited. A search returns at most 12 results a page.
How are the pictures shown?
Hosts that support MCP Apps draw the previews in the conversation. Other hosts lose nothing: every result also carries a preview_url the agent can give the person as a link.
Who can use it, and what does buying need?
- Anyone can search, see previews and read the license, without an account.
- Buying needs an Atelier account, made by the email sign-in above. Buyers must be 18 or older.
- Photographs are bought with credits from a subscription or, where the collection allows, one at a time by card. Every payment is approved by the person on a Stripe checkout page they open; the agent never sees card details. Sales tax or VAT is added at checkout where it is due.
- A new account can claim 3 credits free, once, before paying for anything, in collections that accept them. Images bought with them come as the screen file only.
- Credits buy the personal license. Where a collection offers it, the commercial license is bought by card only, with
create_checkoutandlicence: "commercial"; listings carry its price asprice.commercial. Both licenses forbid training an AI model; the license page has the full terms. The connector buys photographs; photographers cannot upload or sell through it.
For photographers
Can I sell my photographs on Atelier?
Photographers join by invitation for now — join the waitlist. Atelier is also a place to deliver work to clients; selling is one switch on a gallery, off until you turn it on. Your photographs are never used to train an AI model, and every license sold here forbids the buyer from using them to train one.
Something not answered here? Write to [email protected].