20.16 How the pieces fit
- Approved by
- Panaversity ·
5 min read
In everyday life. A shop has goods, staff who know how to sell them, a shop window, and a door with a lock. Each answers a different question, and the shop needs all four.
What you will learn. How the chapter's extensions fit one connector, and the mistakes builders make most.
Why it matters. Each extension answers a different question. Mixing them up leads to the mistakes below, such as treating a screen as a permission.
What does each layer answer?
| Question | Answer | Brightline example |
|---|---|---|
| What can the AI do? | Tools, plain MCP | list_open_invoices, find_vendor |
| How should the AI do the job well? | Skills over MCP | invoice-triage |
| What does the person see and touch? | MCP Apps, with A2UI if the AI shapes the screen | The open-invoices screen |
| Who may use it? | Sign-in, with Enterprise-Managed Authorization and Client Credentials | Luis, Cedar Ridge's employees, the report job |

Figure 20.16. One connector, four layers. Tools and sign-in decide what is allowed. Skills and screens never do.
What are the common mistakes?
| Mistake | Why it hurts | Better |
|---|---|---|
| A screen with no text answer | AI apps without screens show nothing useful | Every tool returns useful text (20.9) |
| A screen for every answer | The chat fills with panels | Show a screen when the person will look or act (20.2) |
| Treating a hidden tool or button as protected | Anyone with a token can call any tool | Check every call in the connector (20.5) |
| Depending on streamed input | Some AI apps never send it | Work from the complete input (20.3) |
Using window.openai extras everywhere | The screen works only in ChatGPT | Build to the standard, and check before using an extra (20.9) |
| Letting the AI write the page | Layout, quality and safety vary | Approved parts, such as A2UI (20.10, 20.11) |
| Generic skill names | Skills from different servers collide | Distinct names (20.13) |
| Changing skill files often | Every change means approving again | Batch and version changes (20.13) |
| Linking accounts by email alone | A reused address can open someone else's records | Issuer and subject (20.14) |
| A job that borrows a person's access | It acts as that person | Its own identity, with the least scope (20.15) |
| Testing only that the screen appears | A screen can appear and still lose the person's work | Test the whole path: sign in, act, reopen, retry |
| Testing in one AI app | Support differs feature by feature | Test every AI app and plan you promise, phones included |
The operating rule: let tools and sign-in decide what is allowed, let skills and screens make the work easier, and test each layer in every AI app you sell into.
Check yourself
Question 1 / 3
0 answered
Which layers decide what is allowed?
- Owner
- Panaversity